encodingapis

Encodes and decodes strings to and from UTF-8 bytes using TextEncoder/TextDecoder.

Import: @rtorcato/browser-common/encodingapis

📖 MDN: TextEncoder · 📊 caniuse: textencoder

encodeUTF8/decodeUTF8 throw where TextEncoder/TextDecoder are unsupported — guard with isTextEncoderAvailable()/isTextDecoderAvailable() first.

Unlike most of this library, this module is environment-agnostic: TextEncoder and TextDecoder are Node.js globals too, so it works outside the browser.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
TextEncoder	✅ 38+	✅ 79+	✅ 18+	✅ 10.1+	✅ 10.3+	Widely available
TextDecoder	✅ 38+	✅ 79+	✅ 19+	✅ 10.1+	✅ 10.3+	Widely available

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: TextEncoder · TextDecoder

Example

import {
  isTextEncoderAvailable,
  encodeUTF8,
  decodeUTF8,
} from '@rtorcato/browser-common/encodingapis'

if (isTextEncoderAvailable()) {
  const bytes = encodeUTF8('hello')
  const text = decodeUTF8(bytes)
}

Exports

• isTextEncoderAvailable() — feature check for TextEncoder
• isTextDecoderAvailable() — feature check for TextDecoder
• encodeUTF8(input) — encodes a string into a Uint8Array
• decodeUTF8(bytes) — decodes a Uint8Array into a string

See the API reference for full signatures.