Home

Awesome

text-encoding-utf-8

This is a partial polyfill for the Encoding Living Standard API for the Web, allowing encoding and decoding of textual data to and from Typed Array buffers for binary data in JavaScript.

This is fork of text-encoding that only support UTF-8.

Basic examples and tests are included.

Install

There are a few ways you can get the text-encoding-utf-8 library.

Node

text-encoding-utf-8 is on npm. Simply run:

npm install text-encoding-utf-8

Or add it to your package.json dependencies.

HTML Page Usage

  <script src="encoding.js"></script>

API Overview

Basic Usage

  var uint8array = TextEncoder(encoding).encode(string);
  var string = TextDecoder(encoding).decode(uint8array);

Streaming Decode

  var string = "", decoder = TextDecoder(encoding), buffer;
  while (buffer = next_chunk()) {
    string += decoder.decode(buffer, {stream:true});
  }
  string += decoder.decode(); // finish the stream

Encodings

Only utf-8 and UTF-8 are supported.

Non-Standard Behavior

Only utf-8 and UTF-8 are supported.

Motivation

Binary size matters, especially on a mobile phone. Safari on iOS does not support TextDecoder or TextEncoder.