TypedArray.prototype.byteLength

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die byteLength Zugriffs- Eigenschaft von TypedArray Instanzen gibt die Länge (in Bytes) dieses typisierten Arrays zurück.

In diesem Artikel

Probieren Sie es aus

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer, 2);

console.log(uint8.byteLength);
// Expected output: 6

Die byteLength-Eigenschaft ist eine Zugriffs-Eigenschaft, deren Set-Accessor-Funktion undefined ist, was bedeutet, dass Sie diese Eigenschaft nur lesen können. Wenn das typisierte Array längenüberwachend ist, hängt seine Länge von der Länge des zugrunde liegenden Puffers ab und kann sich ändern, wenn der Puffer in der Größe verändert wird. Andernfalls wird der Wert beim Erstellen des typisierten Arrays festgelegt und kann nicht geändert werden. Unabhängig davon, ob es sich um eine längenüberwachende Darstellung handelt oder nicht, wird die byteLength zu 0, wenn der zugrunde liegende Puffer so verändert wird, dass der betrachtete Bereich nicht mehr gültig ist.

Beispiele

Verwendung der byteLength-Eigenschaft

js
const buffer = new ArrayBuffer(8);

const uint8 = new Uint8Array(buffer);
uint8.byteLength; // 8 (matches the byteLength of the buffer)

const uint8newLength = new Uint8Array(buffer, 1, 5);
uint8newLength.byteLength; // 5 (as specified when constructing the Uint8Array)

const uint8offset = new Uint8Array(buffer, 2);
uint8offset.byteLength; // 6 (due to the offset of the constructed Uint8Array)

const buffer2 = new ArrayBuffer(16, { maxByteLength: 32 });
const uint8lengthTracking = new Uint8Array(buffer2, 4);
uint8lengthTracking.byteLength; // 12 (16 - 4)
buffer2.resize(20);
uint8lengthTracking.byteLength; // 16 (20 - 4)
buffer2.resize(3);
uint8lengthTracking.byteLength; // 0 (viewed range is no longer valid)

JavaScript typisierte Arrays Leitfaden
TypedArray

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
TypedArray
Statische Methoden
1. from()
2. of()
Statische Eigenschaften
1. BYTES_PER_ELEMENT
2. [Symbol.species]
Instanzmethoden
1. at()
2. copyWithin()
3. entries()
4. every()
5. fill()
6. filter()
7. find()
8. findIndex()
9. findLast()
10. findLastIndex()
11. forEach()
12. includes()
13. indexOf()
14. join()
15. keys()
16. lastIndexOf()
17. map()
18. reduce()
19. reduceRight()
20. reverse()
21. set()
22. slice()
23. some()
24. sort()
25. subarray()
26. toLocaleString()
27. toReversed()
28. toSorted()
29. toString()
30. values()
31. with()
32. [Symbol.iterator]()
Instanzeigenschaften
1. buffer
2. byteLength
3. byteOffset
4. length
Vererbung
Object/Function
Statische Methoden
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Statische Eigenschaften
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Instanzmethoden
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
Instanzeigenschaften
1. __proto__
2. constructor
Verwandte Seiten
BigInt64Array
BigUint64Array
Float16Array
Float32Array
Float64Array
Int8Array
Int16Array
Int32Array
Uint8Array
Uint8ClampedArray
Uint16Array
Uint32Array

TypedArray.prototype.byteLength

In diesem Artikel

Probieren Sie es aus

Beschreibung

Beispiele

Verwendung der byteLength-Eigenschaft

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN