https://github.com/chbrown/unidata

Javascript interface to the Unicode Character Database
https://github.com/chbrown/unidata

Last synced: 4 months ago
JSON representation

Javascript interface to the Unicode Character Database

• Host: GitHub
• URL: https://github.com/chbrown/unidata
• Owner: chbrown
• Created: 2015-05-05T17:10:14.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2020-05-18T15:59:59.000Z (over 5 years ago)
• Last Synced: 2025-06-26T04:06:42.767Z (4 months ago)
• Language: JavaScript
• Size: 429 KB
• Stars: 8
• Watchers: 1
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-typography - unidata - Unicode Character Database for JavaScript. (JavaScript)

README

          
# unidata

[![npm package version](https://badge.fury.io/js/unidata.svg)](https://www.npmjs.com/package/unidata)

JavaScript interface to the [Unicode Character Database](http://www.unicode.org/reports/tr44/).

The package version is intended to match the Unicode version.

    npm install unidata --save

## API

Using ES6 syntax:

    import {getBlocks, getCharacters} from 'unidata'

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 blocks = getBlocks()

    const characters = getCharacters()

These are both just arrays.

* `blocks` is an array of [`Block`](index.d.ts)

* `characters` is an array of [`Character`](index.d.ts)

Blocks are simple; _every_ item in `blocks` has these three fields:

```js

> blocks.length

308

> 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 value is not available or not applicable for a given character, that key will be omitted.

```js

> characters.length

33797

> 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–2020 Christopher Brown.

[MIT Licensed](https://chbrown.github.io/licenses/MIT/#2015-2020).