A simple immutable class representing an array of bytes, used for working with binary data in a scripting context.
It acts as a view to ArrayBuffer. The buffer can be accessed through asUint8Array().
Limitation: The size of the resulting byte representation is limited by the quota api.jsArrayBufferSize that is defining the max size for a ArrayBuffer.
| Constant | Description |
|---|---|
| The maximum number of bytes that a Bytes object can represent == 10KB |
| Property | Description |
|---|---|
length: Number (read-only) | Returns the number of bytes represented by this object. |
| Constructor | Description |
|---|---|
| Bytes(Object) | Construct a Bytes object from the given ArrayBuffer or view. |
| Bytes(String) | Construct a Bytes object from the given string using the default encoding. |
| Bytes(String, String) | Construct a Bytes object from the given string using the given encoding. |
| Method | Description |
|---|---|
| asUint8Array() | Returns a Uint8Array based on the ArrayBuffer used for this Bytes object. |
| byteAt(Number) | Returns the value of the byte at position index as an integer. |
| bytesAt(Number, Number) | Return a new Bytes object containing the subsequence of this object’s bytes specified by the index and length parameters. |
| getLength() | Returns the number of bytes represented by this object. |
| intAt(Number) | Absolute get method for reading a signed integer value (32 bit) in network byte order(= big endian). |
| reverse() | Return a new Bytes object which has the same bytes as this one in reverse order. |
| shortAt(Number) | Absolute get method for reading a signed short value (16 bit) in network byte order(= big endian). |
| toString() | Constructs a new String by decoding this array of bytes using the default encoding. |
| toString(String) | Constructs a new String by decoding this array of bytes using the specified encoding. |
assign, create, create, defineProperties, defineProperty, entries, freeze, fromEntries, getOwnPropertyDescriptor, getOwnPropertyNames, getOwnPropertySymbols, getPrototypeOf, hasOwnProperty, is, isExtensible, isFrozen, isPrototypeOf, isSealed, keys, preventExtensions, propertyIsEnumerable, seal, setPrototypeOf, toLocaleString, toString, valueOf, values
The maximum number of bytes that a Bytes object can represent == 10KB
Deprecated:
No longer used by the Bytes class.
Warning
(read-only)Returns the number of bytes represented by this object.
Construct a Bytes object from the given ArrayBuffer or view. The bytes object also acts as a view on the underlying ArrayBuffer. If a view is given that makes only a part of the storage array visible then this Bytes object will also make only the same part visible. The storage data is not copied.
Parameters:
API Version:
Available from version 21.2.
Note
Construct a Bytes object from the given string using the default encoding. Convenience for Bytes( string, "UTF-8" ).
Parameters:
Throws:
Construct a Bytes object from the given string using the given encoding. This method always replaces malformed input and unmappable character sequences with encoding defaults.
Parameters:
Throws:
Returns a Uint8Array based on the ArrayBuffer used for this Bytes object. Changes to the returned ArrayBuffer will be visible in the Bytes object.
Returns:
API Version:
Available from version 21.2.
Note
Returns the value of the byte at position index as an integer. If index is out of range an exception is thrown. The byte is interpreted as signed and so the value returned will always be between -128 and +127.
Parameters:
Returns:
Throws:
Return a new Bytes object containing the subsequence of this object's bytes specified by the index and length parameters. The returned object is a new view onto the same data, no data is copied.
Parameters:
Returns:
Throws:
Returns the number of bytes represented by this object.
Returns:
Absolute get method for reading a signed integer value (32 bit) in network byte order(= big endian).
Parameters:
Returns:
Throws:
Return a new Bytes object which has the same bytes as this one in reverse order.
Returns:
Absolute get method for reading a signed short value (16 bit) in network byte order(= big endian).
Parameters:
Returns:
Throws:
Constructs a new String by decoding this array of bytes using the default encoding. Convenience for toString( "UTF-8" ). Limitation: The method is protected by the quota api.jsStringLength that prevents creation of too long strings.
Returns:
Constructs a new String by decoding this array of bytes using the specified encoding. Limitation: The method is protected by the quota api.jsStringLength that prevents creation of too long strings.
Parameters:
Returns:
Throws:
j