ArrayBuffer

Bir ArrayBuffer nesnesi, kapsamlı ve sabit uzunluktaki raw binary data buffer'ını temsil etmek için kullanılır. Bir ArrayBuffer'ın içeriklerini direkt olarak manipüle edemezsiniz; bunun yerine, yazılmış dizi nesnelerini veya buffer'ı özel bir formatta temsil eden bir DataView nesnesini oluşturursunuz, buffer'a içerik yazmak veya buffer'dan içerik okumak için kullanırsınız.

Syntax

new ArrayBuffer(length)

Parametreler

length

Byte cinsinden, oluşturulan array buffer'ın boyutudur.

Döndürülen Değer

Belirlenen boyutta yeni bir ArrayBuffer nesnesi. İçeriği 0 atanmış durumdadır.

İstisnalar

Eğer uzunluk Number.MAX_SAFE_INTEGER (>= 2 ** 53) ifadesinden büyük ya da negatif ise bir RangeError fırlatılır.

Tanım

ArrayBuffer constructor'ı, byte cinsinden verilen boyutta yeni bir ArrayBuffer oluşturur.

Var olan bir data'dan array buffer çekmek

• Bir Base64 string'inden
• Yerel bir dosyadan

Özellikler

ArrayBuffer.length

ArrayBuffer constructor'ının 1 değerine sahip uzunluk özelliği.

get ArrayBuffer[@@species]

Türetilmiş nesneleri oluşturmak için kullanılan constructor fonksiyonu.

ArrayBuffer.prototype

Bütün ArrayBuffer nesnelerine özellik eklemeye izin verir.

Metodlar

ArrayBuffer.isView(arg)

Eğer arg bir ArrayBuffer view'i ise true döndürür, tıpkı yazılmış dizi nesneleri veya bir DataViewgibi. Aksi halde false döndürür.

ArrayBuffer.transfer(oldBuffer [, newByteLength])

oldBuffer'ın alınmış, ardından kesilmiş veya newByteLength tarafından sıfır-uzatılmış datasını içeren yeni bir ArrayBuffer döndürür.

ArrayBuffer oluşumları

Bütün ArrayBuffer oluşumları ArrayBuffer.prototype tarafından miras alınır.

Özellikler

ArrayBuffer.prototype.constructor

Specifies the function that creates an object's prototype. The initial value is the standard built-in ArrayBuffer constructor.

ArrayBuffer.prototype.byteLength Read only

The size, in bytes, of the array. This is established when the array is constructed and cannot be changed. Read only.

Metodlar

ArrayBuffer.prototype.slice()

Returns a new ArrayBuffer whose contents are a copy of this ArrayBuffer's bytes from begin, inclusive, up to end, exclusive. If either begin or end is negative, it refers to an index from the end of the array, as opposed to from the beginning.

ArrayBuffer.slice()

ArrayBuffer.prototype.slice() ile aynı fonksiyonelliğe sahiptir.

Örnek

Bu örnekte,  Int32Array view'i aracılığıyla 8-byte'lık bir buffer oluştururuz.

var buffer = new ArrayBuffer(8);
var view   = new Int32Array(buffer);

Belirtmeler

Tarayıcı Uyumluluğu

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Uyumluluk Notları

 ECMAScript 2015'ten başlamak üzere, ArrayBuffer constructor'ları bir new operatörü aracılığıyla inşa edilmeye ihtiyaç duymaktadır. Artık new fonksiyonu kullanmadan bir ArrayBuffer constructor'ı çağırmak, bir  TypeError fırlatacaktır.

var dv = ArrayBuffer(10);
// TypeError:new komutu olmadan
// Gömülü bir ArrayBuffer constructor'u çağırmak 

var dv = new ArrayBuffer(10);

Ayrıca Bakınız

• Yazılmış JavaScript Dizileri
• SharedArrayBuffer