JavaScript TextEncoder — рядок у байти UTF-8

TextEncoder перетворює рядок на байти UTF-8 — Uint8Array.

правити

Загальний опис

Рядок у JavaScript і байти у файлі — різні речі. Українська літера займає два байти, емодзі — чотири, тож text.length (кількість символів) і реальний розмір у байтах — різні числа.

Кодувальник потрібен усюди, де дані йдуть у двійковий світ: криптографія (crypto.subtle приймає лише байти), WebSocket у двійковому режимі, підрахунок справжнього розміру перед відправкою.

Кодування завжди UTF-8 — іншого варіанта немає й не передбачено.

правити

+ додати пораду чи нотатку

Синтаксис

const bytes = new TextEncoder().encode("текст");

властивості

методи

Переглядачі

Стаціонарні переглядачі Мобільні переглядачі Серверні переглядачі

Підтримка: стаціонарні переглядачі

Переглядач
	38	18	10.1	25	79	—

Підтримка: мобільні переглядачі

Переглядач
	38	38	18	10.3

Підтримка: серверні переглядачі

Переглядач
	11.0.0	1.0

Приклади

+ запропонувати свій приклад у пісочниці

// top-level await працює лише в модулях — тут той самий код в async-функції
(async () => {
    const encoder = new TextEncoder();
    const bytes = encoder.encode('Привіт 👋');

    console.log('Привіт 👋'.length); // 9 символів
    console.log(bytes.length);       // 17 байтів — не те саме!

    // crypto приймає лише байти
    const hash = await crypto.subtle.digest('SHA-256', encoder.encode('пароль'));
    console.log(new Uint8Array(hash).length); // 32
})();