From b66034afeee8e7d5bec88a974a30226e109ae3a2 Mon Sep 17 00:00:00 2001 From: Anderson Vallejo <48649209+Vallejoanderson@users.noreply.github.com> Date: Mon, 14 Feb 2022 11:25:35 -0500 Subject: Content sync and updated to md | Arraybuffer/index [ES] (#4128) * sync and updated to md * Update files/es/web/javascript/reference/global_objects/arraybuffer/index.md Update the text to fix a broken a hyperlink Co-authored-by: David Brito <39559632+davbrito@users.noreply.github.com> * Update files/es/web/javascript/reference/global_objects/arraybuffer/index.md Update the text to match the english's version. Co-authored-by: David Brito <39559632+davbrito@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: David Brito <39559632+davbrito@users.noreply.github.com> Co-authored-by: Sergio.valera Co-authored-by: David Brito <39559632+davbrito@users.noreply.github.com> --- .../global_objects/arraybuffer/index.html | 140 --------------------- .../reference/global_objects/arraybuffer/index.md | 65 ++++++++++ 2 files changed, 65 insertions(+), 140 deletions(-) delete mode 100644 files/es/web/javascript/reference/global_objects/arraybuffer/index.html create mode 100644 files/es/web/javascript/reference/global_objects/arraybuffer/index.md (limited to 'files/es/web/javascript/reference/global_objects/arraybuffer') diff --git a/files/es/web/javascript/reference/global_objects/arraybuffer/index.html b/files/es/web/javascript/reference/global_objects/arraybuffer/index.html deleted file mode 100644 index 376a023b50..0000000000 --- a/files/es/web/javascript/reference/global_objects/arraybuffer/index.html +++ /dev/null @@ -1,140 +0,0 @@ ---- -title: ArrayBuffer -slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer -tags: - - ArrayBuffer - - Constructor - - JavaScript - - TypedArrays -translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer -original_slug: Web/JavaScript/Referencia/Objetos_globales/ArrayBuffer ---- -
{{JSRef}}
- -

El objeto ArrayBuffer se usa para representar un buffer genérico, de datos binarios crudos (raw) con una longitud específica. No se puede manipular directamente el contenido de un ArrayBuffer; sin embargo, puedes crear uno de los arrays tipados o un objeto {{jsxref("DataView")}} que representa el buffer en un formato especifico, y usarlo para leer y escribir el contenido del buffer.

- -

{{EmbedInteractiveExample("pages/js/arraybuffer-constructor.html")}}

- -

Sintaxis

- -
new ArrayBuffer(length)
-
- -

Parámetros

- -
-
length
-
El tamaño en bytes, del array buffer que quieres crear.
-
- -

Valor de retorno

- -

Un nuevo objeto ArrayBuffer de tamaño específico. Su contenido se inicializa a cero.

- -

Excepciones

- -

Se lanza un {{jsxref("RangeError")}} si la longitud (length) es mayor que {{jsxref("Number.MAX_SAFE_INTEGER")}} (> = 2 ** 53) o negativa.

- -

Descripción

- -

El constructor de ArrayBuffer crea un nuevo ArrayBuffer del tamaño especificado en bytes.

- -

Obtener un array buffer sobre datos existentes

- - - -

Propiedades

- -
-
ArrayBuffer.length
-
El tamaño de constructor de ArrayBuffer cuyo valor es 1.
-
{{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}
-
La función de constructor que se usa para crear objetos derivados.
-
{{jsxref("ArrayBuffer.prototype")}}
-
Permite añadir propiedades a todos los objetos ArrayBuffer.
-
- -

Métodos

- -
-
{{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}}
-
Devuelve true si arg es una de las vistas de ArrayBuffer, como pueden ser los arrays tipados o un {{jsxref("DataView")}}. Sino devuelve false.
-
{{jsxref("ArrayBuffer.transfer", "ArrayBuffer.transfer(oldBuffer [, newByteLength])")}} {{experimental_inline}}
-
-
Devuelve un nuevo ArrayBuffer cuyo contenido se toma de los datos de oldBuffer y luego es truncado o extendido por cero por newByteLength.
-
-
- -

Instancias

- -

Todas las instancias de ArrayBuffer heredan de {{jsxref("ArrayBuffer.prototype")}}.

- -

Propiedades

- -

{{page('es/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Propiedades')}}

- -

Métodos

- -

{{page('es/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Métodos')}}

- -
-
{{jsxref("ArrayBuffer.slice()")}} {{non-standard_inline}}
-
Tiene la misma funcionalidad que {{jsxref("ArrayBuffer.prototype.slice()")}}.
-
- -

Ejemplo

- -

En este ejemplo creamos un buffer de 8-bytes con una vista del tipo {{jsxref("Global_Objects/Int32Array", "Int32Array")}} referenciando dicho buffer:

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

Especificaciones

- - - - - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName('Typed Array')}}{{Spec2('Typed Array')}}Sustituida por ECMAScript 6.
{{SpecName('ES6', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}{{Spec2('ES6')}}Definición inicial en un estándar ECMA. Especifica que new es obligatorio.
{{SpecName('ESDraft', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}{{Spec2('ESDraft')}} 
- -

Compatibilidad con navegadores

- -

{{Compat("javascript.builtins.ArrayBuffer")}}

- -

Notas de compatibilidad

- -

Desde el ECMAScript 2015, los constructores de ArrayBuffer requieren ser instanciados usando el operador {{jsxref("Operators/new", "new")}}. Ejecutar el constructor de un ArrayBuffer como una funciónsin el new, lanzará un {{jsxref("TypeError")}} de ahora en adelante.

- -
var dv = ArrayBuffer(10);
-// TypeError: llamar al constructor ArrayBuffer sin new está prohibido
- -
var dv = new ArrayBuffer(10);
- -

Ver también

- - diff --git a/files/es/web/javascript/reference/global_objects/arraybuffer/index.md b/files/es/web/javascript/reference/global_objects/arraybuffer/index.md new file mode 100644 index 0000000000..9ac51caf89 --- /dev/null +++ b/files/es/web/javascript/reference/global_objects/arraybuffer/index.md @@ -0,0 +1,65 @@ +--- +title: ArrayBuffer +slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer +translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer +original_slug: Web/JavaScript/Reference/Global_Objects/ArrayBuffer +browser-compat: javascript.builtins.ArrayBuffer +--- +{{JSRef}} + +El objeto **`ArrayBuffer`** se usa para representar un buffer genérico, de datos binarios brutos con una longitud específica. + +Es un arreglo de bytes, frecuentemente llamado de esta forma en otros lenguajes de programación. No se puede manipular directamente el contenido de un `ArrayBuffer`; en su lugar, se crea uno de los [objetos de arreglos tipados](/es/docs/Web/JavaScript/Reference/Global_Objects/TypedArray) o un objeto {{jsxref("DataView")}} que representa el buffer en un formato específico, y se usa para leer y escribir el contenido del buffer. + +El constructor [`ArrayBuffer`](/es/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/ArrayBuffer) crea un nuevo `ArrayBuffer` de la longitud especificada en bytes. También se puede obtener un `ArrayBuffer` desde datos existentes, por ejemplo, desde una cadena de caracteres en [Base64](/es/docs/Glossary/Base64) o desde un archivo local. + +## Constructor + +- {{jsxref("ArrayBuffer.ArrayBuffer", "ArrayBuffer()")}} + - : Crea un nuevo objeto `ArrayBuffer`. + +## Propiedades estáticas + +- {{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}} + - : La función constructora que se usa para crear objetos derivados. + +## Métodos estáticos + +- {{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}} + - : Devuelve `true` si `arg` es una de las vistas de `ArrayBuffer`, como [objetos de arreglo tipados](/es/docs/Web/JavaScript/Reference/Global_Objects/TypedArray) o un {{jsxref("DataView")}}. Devuelve `false` en caso contrario. + +## Propiedades de instancias + +- {{jsxref("ArrayBuffer.prototype.byteLength")}} + - : Propiedad de solo lectura con la longitud en bytes del `ArrayBuffer`. Se establece cuando el arreglo es construido y no puede ser cambiada. + +## Métodos de instancias + +- {{jsxref("ArrayBuffer.prototype.slice()")}} + - : Devuelve un nuevo `ArrayBuffer` que contiene una copia de los bytes de este `ArrayBuffer` desde el comienzo (inclusivo) `begin` hasta el fin (exclusivo) `end`. Si `begin` o `end` son negativos, esto se refiere a un índice desde el final del arreglo, en lugar del comienzo. + +## Ejemplos + +### Creando un `ArrayBuffer` + +En este ejemplo, se crea un buffer de 8 bytes con una vista {{jsxref("Int32Array")}} consultando el buffer. + +```js +const buffer = new ArrayBuffer(8); +const view = new Int32Array(buffer); +``` + +## Especificaciones + +{{Specifications}} + +## Compatibilidad con navegadores + +{{Compat}} + +## Véase también + +- Un polyfill de `ArrayBuffer` está disponible en [`core-js`](https://github.com/zloirock/core-js#ecmascript-typed-arrays) +- [Arraglos tipados en JavaScript](/es/docs/Web/JavaScript/Typed_arrays) +- {{jsxref("SharedArrayBuffer")}} +- [RangeError: longitud de array invalida](/es/docs/Web/JavaScript/Reference/Errors/Invalid_array_length) -- cgit v1.2.3-54-g00ecf