Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

TextEncoder.encode() — pretvorba besedila v bajte UTF-8

TextEncoder.encode() kodira niz JavaScript kot UTF-8 in vrne Uint8Array z nastalimi bajti. Metodo pokličite na primerku TextEncoder; število bajtov se ne ujema nujno z dolžino niza.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const encoder = new TextEncoder();
const bytes = encoder.encode(text);

TextEncoder.encode je instančna metoda: ustvarite objekt z new TextEncoder() in nato pokličite encoder.encode(text). Rezultat je Uint8Array z bajti besedila v UTF-8, ne nov niz. TextEncoder podpira samo UTF-8; ne omogoča izbire drugih kodiranj.

Ne enačite text.length z velikostjo kodiranih podatkov. Dolžina niza JavaScript se meri v kodnih enotah UTF-16, medtem ko bytes.length šteje nastale bajte. V primeru A zasede en bajt, € pa tri: niz "A€" ima dolžino 2, kodirani rezultat pa vsebuje 4 bajte.

encode() ustvari rezultatno polje. Če želite pisati v obstoječi Uint8Array, razmislite o ločeni metodi encodeInto(): sprejme ciljno polje in namesto polja bajtov vrne podatke o napredku. Njeno podporo preverite neodvisno od podpore za encode().

To je spletni API, opredeljen v standardu Encoding, in ne funkcija, povezana z določeno izdajo ECMAScripta. Po navedbah MDN je encode() široko podprt v brskalnikih od januarja 2020 in deluje tudi v Web Workers. Njegova prisotnost v Node 24 ne dokazuje, da je podprt v ciljnem brskalniku.

Primeri

const text = "A€";
const encoder = new TextEncoder();
const bytes = encoder.encode(text);

console.log(bytes instanceof Uint8Array);
console.log(bytes.join(","));
console.log(text.length, bytes.length);

Rezultat

true
65,226,130,172
2 4

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri