Skip to content

arv/text-encoding-utf-8

 
 

Repository files navigation

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.

About

Polyfill for the Encoding Living Standard's API

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 95.4%
  • HTML 4.6%