CKTIS / JavaScript
TextEncoder.encode und TypedArray.byteLength: UTF-8-Bytes zählen
Kodiere Text als UTF-8 und lies die resultierende Byteanzahl aus. Unterscheide sie von der Anzahl der UTF-16-Codeeinheiten, der Elementanzahl eines typisierten Arrays und der Größe des gesamten Puffers.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const encoder = new TextEncoder();
const bytes = encoder.encode(text);
const byteCount = bytes.byteLength;
// With no argument, encoder.encode() returns an empty Uint8Array.
// For any typed-array instance: view.byteLengthnew TextEncoder().encode(text) ruft eine Instanzmethode auf, die eine Zeichenfolge ausschließlich als UTF-8 kodiert und ein neues Uint8Array zurückgibt. Ohne Argument gibt sie ein leeres Uint8Array zurück. Jede ungepaarte Surrogat-Codeeinheit wird durch U+FFFD ersetzt, statt einen Fehler auszulösen.
view.byteLength ist eine schreibgeschützte Eigenschaft, keine Methode. Sie zählt die Bytes der Ansicht. view.length zählt die Elemente, und view.buffer.byteLength zählt die Bytes im gesamten zugrunde liegenden Puffer. Liegt die Ansicht innerhalb der Puffergrenzen, gilt view.byteLength = view.length * view.BYTES_PER_ELEMENT. In einem Uint8Array belegt jedes Element ein Byte. text.length zählt UTF-16-Codeeinheiten, keine UTF-8-Bytes. Prüfe bei einem Limit in UTF-8-Bytes daher bytes.byteLength.
ECMAScript 2024 definiert die Eigenschaft typisierter Arrays. TextEncoder ist eine API der Webplattform; ihre Verfügbarkeit hängt von der Laufzeitumgebung ab. Bei einem Puffer mit veränderbarer Größe kann sich die Größe einer Ansicht ändern, die der Puffergröße folgt. Ist der Puffer abgetrennt oder liegt die Ansicht außerhalb seiner Grenzen, ergibt das Lesen von byteLength den Wert 0. Der Getter wirft TypeError, wenn er auf einem Objekt aufgerufen wird, das kein typisiertes Array ist.
Beispiele
{
const text = "Aé🙂";
const bytes = new TextEncoder().encode(text);
console.log(`text.length=${text.length}; bytes.length=${bytes.length}; bytes.byteLength=${bytes.byteLength}`);
console.log(bytes.join(","));
const view = new Uint16Array(new ArrayBuffer(12), 2, 3);
console.log(`view.length=${view.length}; view.byteLength=${view.byteLength}; view.buffer.byteLength=${view.buffer.byteLength}`);
}Ergebnis
text.length=4; bytes.length=7; bytes.byteLength=7 65,195,169,240,159,153,130 view.length=3; view.byteLength=6; view.buffer.byteLength=12
`Aé🙂` benötigt 4 UTF-16-Codeeinheiten und 7 UTF-8-Bytes. Die `Uint16Array`-Ansicht hat 3 Elemente zu je 2 Byte und belegt damit 6 der 12 Bytes des Puffers.
Zugehörige Lektionen
- JavaScript · Lektion 17 · Fortgeschritten · Version: 4