TheTextEncoder interface enables you toencode a JavaScript string usingUTF-8.

Constructor

TextEncoder()

Creates and returns a newTextEncoder.

Instance properties

TheTextEncoder interface doesn't inherit any properties.

TextEncoder.encodingRead only

Always returnsutf-8.

Instance methods

TheTextEncoder interface doesn't inherit any methods.

TextEncoder.encode()

Takes a string as input, and returns aUint8Array containing the string encoded using UTF-8.

TextEncoder.encodeInto()

Takes a string to encode and a destinationUint8Array to put the resulting UTF-8 encoded text into, and returns an object indicating the progress of the encoding.This is potentially more performant than the olderencode() method.

Examples

Encoding to UTF-8

This example shows how to encode the "€" character to UTF-8.

<button>Encode</button><button>Reset</button><div></div>

div {  margin: 1rem 0;}

const utf8encoder = new TextEncoder();const text = "€";const output = document.querySelector("#output");const encodeButton = document.querySelector("#encode");encodeButton.addEventListener("click", () => {  output.textContent = utf8encoder.encode(text);});const resetButton = document.querySelector("#reset");resetButton.addEventListener("click", () => {  window.location.reload();});

Specifications

Browser compatibility

See also

• TheTextDecoder interface describing the inverse operation.