1.0.0 • Published 7 years ago

fast-cbor v1.0.0

Weekly downloads
1
License
MIT
Repository
github
Last release
7 years ago

fast-cbor

npm.io npm.io npm.io Coverage Status Dependency Status Travis CI Circle CI

Encode and parse data in the Concise Binary Object Representation (CBOR) data format (RFC7049) as fast as possible.

About

This library is a fork of the awesome node-cbor(standard-readme compliant ). It borrows a lot of the interface, but drops all streaming and async processing in favor of a minimal syn api and being as fast as possible.

Installation

$ npm install --save fast-cbor

Benchmarks

TODO

Example

const cbor = require('cbor')
const assert = require('assert')

const encoded = cbor.encode(true) // returns <Buffer f5>
const decoded = cbor.decodeFirst(encoded)
// decoded is the unpacked object
assert.ok(obj === true);

// Use integers as keys?
var m = new Map();
m.set(1, 2);
encoded = cbor.encode(m); // <Buffer a1 01 02>

The sync encoding and decoding are exported as a leveldb encoding, as cbor.leveldb.

Supported types

The following types are supported for encoding:

  • boolean
  • number (including -0, NaN, and ±Infinity)
  • string
  • Array, Set (encoded as Array)
  • Object (including null), Map
  • undefined
  • Buffer
  • Date,
  • RegExp
  • url.URL
  • bignumber

Decoding supports the above types, including the following CBOR tag numbers:

TagGenerated Type
0Date
1Date
2bignumber
3bignumber
4bignumber
5bignumber
32url.URL
35RegExp

Extending

Encoders

TODO

Decoders

TODO

Developers

TODO