unidata10
v10.0.1
Published
Javascript interface to the Unicode Character Database, updated for Unicode 10.0.0
Downloads
10
Readme
unidata
Javascript interface to the Unicode Character Database (currently using Unicode 10.0.0).
npm install unidata10 --save
API
Using ES6 syntax:
import {getBlocks, getCharacters} from 'unidata10';
There are a few other exports (and a couple useful interfaces, if you're using TypeScript), but these are the main methods.
They both simply call require()
to load the preprocessed Unicode data from a JSON file.
const characters = getCharacters();
const blocks = getBlocks();
These are both just arrays. characters
is a list of Character
, and blocks
is an array of Block
. Blocks are simple; every item in blocks
has these three fields:
> blocks.length
262
> blocks.slice(0, 5)
[ { startCode: 0, endCode: 127, blockName: 'Basic Latin' },
{ startCode: 128, endCode: 255, blockName: 'Latin-1 Supplement' },
{ startCode: 256, endCode: 383, blockName: 'Latin Extended-A' },
{ startCode: 384, endCode: 591, blockName: 'Latin Extended-B' },
{ startCode: 592, endCode: 687, blockName: 'IPA Extensions' } ]
Characters are richer, but the representation is parsimonious: if a field is not available or not applicable for a given character, that key will be undefined.
> characters.length
29215
> characters.slice(32, 40)
[ { code: 32, name: 'SPACE', cat: 'Zs', bidi: 'WS' },
{ code: 33, name: 'EXCLAMATION MARK', cat: 'Po', bidi: 'ON' },
{ code: 34, name: 'QUOTATION MARK', cat: 'Po', bidi: 'ON' },
{ code: 35, name: 'NUMBER SIGN', cat: 'Po', bidi: 'ET' },
{ code: 36, name: 'DOLLAR SIGN', cat: 'Sc', bidi: 'ET' },
{ code: 37, name: 'PERCENT SIGN', cat: 'Po', bidi: 'ET' },
{ code: 38, name: 'AMPERSAND', cat: 'Po', bidi: 'ON' },
{ code: 39, name: 'APOSTROPHE', cat: 'Po', bidi: 'ON', oldName: 'APOSTROPHE-QUOTE' } ]
The first three fields, code
, name
, and cat
, are always present.
The other ten are optional.
(For details on the optional fields, and what values to assume when they are omitted, see the comments on the Block
interface.)
License
Copyright 2015 Christopher Brown. MIT Licensed.
Updated for Unicode 10.0.0 by Ben Weinshel.