CKTIS / JavaScript
TextEncoder.encode en TypedArray.byteLength: UTF-8-bytes tellen
Codeer tekst als UTF-8 en lees het aantal bytes van het resultaat. Maak onderscheid tussen dat aantal, het aantal UTF-16-code-eenheden, het aantal elementen in een typed array en de grootte van de hele buffer.
Versie: 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) roept een instantiemethode aan die een tekenreeks uitsluitend als UTF-8 codeert en een nieuwe Uint8Array teruggeeft. Zonder argument geeft de methode een lege Uint8Array terug. Elke ongepaarde surrogaatcode-eenheid wordt vervangen door U+FFFD in plaats van een fout te veroorzaken.
view.byteLength is een alleen-lezen eigenschap, geen methode. Deze telt de bytes in de weergave. view.length telt elementen en view.buffer.byteLength telt de bytes van de volledige onderliggende buffer. Valt de weergave binnen de buffergrenzen, dan is view.byteLength gelijk aan view.length * view.BYTES_PER_ELEMENT. In een Uint8Array beslaat elk element één byte. text.length telt UTF-16-code-eenheden, geen UTF-8-bytes. Gebruik bytes.byteLength om een limiet in UTF-8-bytes te controleren.
ECMAScript 2024 specificeert deze eigenschap van typed arrays. TextEncoder is een API van het webplatform en de beschikbaarheid hangt af van de uitvoeromgeving. Bij een buffer waarvan de grootte kan veranderen, kan een weergave die de buffergrootte volgt eveneens van grootte veranderen. Het lezen van byteLength levert 0 op als de buffer is losgekoppeld of de weergave buiten de buffergrenzen valt. De getter aanroepen op een object dat geen typed array is, veroorzaakt een TypeError.
Voorbeelden
{
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}`);
}Resultaat
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é🙂` neemt 4 UTF-16-code-eenheden en 7 UTF-8-bytes in beslag. De `Uint16Array`-weergave bevat 3 elementen van elk 2 bytes en beslaat dus 6 van de 12 bytes van de buffer.
Gerelateerde lessen
- JavaScript · Les 17 · Gevorderd · Versie: 4