Skip to content

Commit 9ed610f

Browse files
committed
fix readme
1 parent 8cf499b commit 9ed610f

1 file changed

Lines changed: 25 additions & 23 deletions

File tree

README.md

Lines changed: 25 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ This is a JavaScript/ECMA-262 implementation of **MessagePack**, an efficient bi
88

99
https://msgpack.org/
1010

11-
This library is a universal JavaScript, which suppors both browsers and NodeJS. In addition, because it is implemented in [TypeScript](https://www.typescriptlang.org/), type definition files (`d.ts`) are bundled in the distribution.
11+
This library is a universal JavaScript, which supports both browsers and NodeJS. In addition, because it is implemented in [TypeScript](https://www.typescriptlang.org/), type definition files (`d.ts`) are bundled in the distribution.
1212

1313
*Note that this is the second version of MessagePack for JavaScript. The first version, which was implemented in ES5 and was never released to npmjs.com, is tagged as [classic](https://github.com/msgpack/msgpack-javascript/tree/classic).*
1414

@@ -42,38 +42,38 @@ deepStrictEqual(decode(encoded), object);
4242
- [Table of Contents](#table-of-contents)
4343
- [Install](#install)
4444
- [API](#api)
45-
- [`encode(data: unknown, options?: EncodeOptions): Uint8Array`](#encodedata-unknown-options-encodeoptions-uint8array)
46-
- [`EncodeOptions`](#encodeoptions)
47-
- [`decode(buffer: ArrayLike<number> | ArrayBuffer, options?: DecodeOptions): unknown`](#decodebuffer-arraylikenumber--arraybuffer-options-decodeoptions-unknown)
48-
- [`DecodeOptions`](#decodeoptions)
49-
- [`decodeAsync(stream: AsyncIterable<ArrayLike<number>> | ReadableStream<ArrayLike<number>>, options?: DecodeAsyncOptions): Promise<unknown>`](#decodeasyncstream-asynciterablearraylikenumber--readablestreamarraylikenumber-options-decodeasyncoptions-promiseunknown)
50-
- [`decodeArrayStream(stream: AsyncIterable<ArrayLike<number>> | ReadableStream<ArrayLike<number>>, options?: DecodeAsyncOptions): AsyncIterable<unknown>`](#decodearraystreamstream-asynciterablearraylikenumber--readablestreamarraylikenumber-options-decodeasyncoptions-asynciterableunknown)
51-
- [`decodeStream(stream: AsyncIterable<ArrayLike<number>> | ReadableStream<ArrayLike<number>>, options?: DecodeAsyncOptions): AsyncIterable<unknown>`](#decodestreamstream-asynciterablearraylikenumber--readablestreamarraylikenumber-options-decodeasyncoptions-asynciterableunknown)
52-
- [Extension Types](#extension-types)
53-
- [Handling BigInt with ExtensionCodec](#handling-bigint-with-extensioncodec)
54-
- [The temporal module as timestamp extensions](#the-temporal-module-as-timestamp-extensions)
45+
- [`encode(data: unknown, options?: EncodeOptions): Uint8Array`](#encodedata-unknown-options-encodeoptions-uint8array)
46+
- [`EncodeOptions`](#encodeoptions)
47+
- [`decode(buffer: ArrayLike<number> | ArrayBuffer, options?: DecodeOptions): unknown`](#decodebuffer-arraylikenumber--arraybuffer-options-decodeoptions-unknown)
48+
- [`DecodeOptions`](#decodeoptions)
49+
- [`decodeAsync(stream: AsyncIterable<ArrayLike<number>> | ReadableStream<ArrayLike<number>>, options?: DecodeAsyncOptions): Promise<unknown>`](#decodeasyncstream-asynciterablearraylikenumber--readablestreamarraylikenumber-options-decodeasyncoptions-promiseunknown)
50+
- [`decodeArrayStream(stream: AsyncIterable<ArrayLike<number>> | ReadableStream<ArrayLike<number>>, options?: DecodeAsyncOptions): AsyncIterable<unknown>`](#decodearraystreamstream-asynciterablearraylikenumber--readablestreamarraylikenumber-options-decodeasyncoptions-asynciterableunknown)
51+
- [`decodeStream(stream: AsyncIterable<ArrayLike<number>> | ReadableStream<ArrayLike<number>>, options?: DecodeAsyncOptions): AsyncIterable<unknown>`](#decodestreamstream-asynciterablearraylikenumber--readablestreamarraylikenumber-options-decodeasyncoptions-asynciterableunknown)
52+
- [Extension Types](#extension-types)
53+
- [Handling BigInt with ExtensionCodec](#handling-bigint-with-extensioncodec)
54+
- [The temporal module as timestamp extensions](#the-temporal-module-as-timestamp-extensions)
5555
- [MessagePack Specification](#messagepack-specification)
56-
- [MessagePack Mapping Table](#messagepack-mapping-table)
56+
- [MessagePack Mapping Table](#messagepack-mapping-table)
5757
- [Prerequsites](#prerequsites)
58-
- [ECMA-262](#ecma-262)
59-
- [NodeJS](#nodejs)
58+
- [ECMA-262](#ecma-262)
59+
- [NodeJS](#nodejs)
6060
- [Benchmark](#benchmark)
6161
- [Distribution](#distribution)
62-
- [NPM / npmjs.com](#npm--npmjscom)
63-
- [CDN / unpkg.com](#cdn--unpkgcom)
62+
- [NPM / npmjs.com](#npm--npmjscom)
63+
- [CDN / unpkg.com](#cdn--unpkgcom)
6464
- [Maintenance](#maintenance)
65-
- [Testing](#testing)
66-
- [Continuous Integration](#continuous-integration)
67-
- [Release Engineering](#release-engineering)
68-
- [Updating Dependencies](#updating-dependencies)
65+
- [Testing](#testing)
66+
- [Continuous Integration](#continuous-integration)
67+
- [Release Engineering](#release-engineering)
68+
- [Updating Dependencies](#updating-dependencies)
6969
- [Big Thanks](#big-thanks)
7070
- [License](#license)
7171

7272
<!-- /TOC -->
7373

7474
## Install
7575

76-
This library is publised as [@msgpack/msgpack](https://www.npmjs.com/package/@msgpack/msgpack) in npmjs.com.
76+
This library is published to `npmjs.com` as [@msgpack/msgpack](https://www.npmjs.com/package/@msgpack/msgpack).
7777

7878
```shell
7979
npm install @msgpack/msgpack
@@ -94,7 +94,7 @@ const encoded: Uint8Array = encode({ foo: "bar" });
9494
console.log(encoded);
9595
```
9696

97-
If you'd like to get a NodeJS `Buffer` instead of `Uint8Array`, use `Buffer.from(arrayBuffer, offset, length)` in order not to copy the underlying `ArrayBuffer`,while `Buffer.from(uint8array)` copies data:
97+
If you'd like to convert the uint8array to a NodeJS `Buffer`, use `Buffer.from(arrayBuffer, offset, length)` in order not to copy the underlying `ArrayBuffer`, while `Buffer.from(uint8array)` copies it:
9898

9999
```typescript
100100
import { encode } from "@msgpack/msgpack";
@@ -118,7 +118,7 @@ forceFloat32 | boolean | false
118118

119119
### `decode(buffer: ArrayLike<number> | ArrayBuffer, options?: DecodeOptions): unknown`
120120

121-
It decodes `buffer` encoded as MessagePack, and returns a decoded object as `uknown`.
121+
It decodes `buffer` encoded in MessagePack, and returns a decoded object as `uknown`.
122122

123123
`buffer` must be an array of bytes, which is typically `Uint8Array`, or `ArrayBuffer`.
124124

@@ -132,6 +132,8 @@ const object = decode(encoded);
132132
console.log(object);
133133
```
134134

135+
NodeJS `Buffer` is also acceptable because it is a subclass of `Uint8Array`.
136+
135137
#### `DecodeOptions`
136138

137139
Name|Type|Default

0 commit comments

Comments
 (0)