vn

validate-note

🎼 Validates a note (scientific pitch notation) and throws errors if needed

Showing:

Popularity

Downloads/wk

26

Maintenance

No Maintenance Data Available

Package

Dependencies

0

Size (min+gzip)

0.6KB

License

MIT

Type Definitions

Tree-Shakeable

Yes?

Categories

Readme

validate-note

Node NPM David Travis Coverage Status Gitmoji

🎼 Validates a note (scientific pitch notation) and throws errors if needed

Usage


import validateNote from 'validate-note';

const note = validateNote('A#4');
console.log(note); // > { letter: 'A', signature: '#', octave: 4 }

Installation

Install via yarn

yarn add validate-note (--dev)

or npm

npm install validate-note (--save-dev)

configuration

You can pass in extra options (βž• required, βž– optional, ✏️ default)


import validateNote from 'validate-note';

const note = validateNote('Bb4', {
  flatToSharp: true,
  maxOctave: 5,
  octave: true
});

console.log(note); // > { letter: 'A', signature: '#', octave: 4 }

βž– maxOctave ( Number ) ✏️ 8
πŸ“ max octave allowed

βž– flatToSharp ( Boolean ) ✏️ false
πŸ“ convert flats (b) to sharps (#)

βž– octave ( Boolean ) ✏️ false
πŸ“ octave is required
ℹ️ A# throws error, A#3 is a valid note

Builds

If you don't use a package manager, you can access validate-note via unpkg (CDN), download the source, or point your package manager to the url.

validate-note is compiled as a collection of CommonJS modules & ES2015 modules for bundlers that support the jsnext:main or module field in package.json (Rollup, Webpack 2)

The validate-note package includes precompiled production and development UMD builds in the dist folder. They can be used directly without a bundler and are thus compatible with many popular JavaScript module loaders and environments. You can drop a UMD build as a <script> tag on your page. The UMD builds make validate-note available as a window.validateNote global variable.

License

The code is available under the MIT license.

Contributing

We are open to contributions, see CONTRIBUTING.md for more info.

Misc

This module was created using generator-module-boilerplate.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100