diff options
author | Anderson Vallejo <48649209+Vallejoanderson@users.noreply.github.com> | 2022-02-14 11:25:35 -0500 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-02-14 12:25:35 -0400 |
commit | b66034afeee8e7d5bec88a974a30226e109ae3a2 (patch) | |
tree | 5ff918c1a3e8e1cf1e8c10f23f087d75850ce604 /files/es/web | |
parent | 90bd95a04f42c46d7d2d849d986e0e8cc78185c7 (diff) | |
download | translated-content-b66034afeee8e7d5bec88a974a30226e109ae3a2.tar.gz translated-content-b66034afeee8e7d5bec88a974a30226e109ae3a2.tar.bz2 translated-content-b66034afeee8e7d5bec88a974a30226e109ae3a2.zip |
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 <sergiovaladez@duck.com>
Co-authored-by: David Brito <39559632+davbrito@users.noreply.github.com>
Diffstat (limited to 'files/es/web')
-rw-r--r-- | files/es/web/javascript/reference/global_objects/arraybuffer/index.html | 140 | ||||
-rw-r--r-- | files/es/web/javascript/reference/global_objects/arraybuffer/index.md | 65 |
2 files changed, 65 insertions, 140 deletions
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 ---- -<div>{{JSRef}}</div> - -<p>El objeto <strong><code>ArrayBuffer</code></strong> 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 <code>ArrayBuffer</code>; sin embargo, puedes crear uno de los <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">arrays tipados</a> o un objeto {{jsxref("DataView")}} que representa el buffer en un formato especifico, y usarlo para leer y escribir el contenido del buffer.</p> - -<p>{{EmbedInteractiveExample("pages/js/arraybuffer-constructor.html")}}</p> - -<h2 id="Sintaxis">Sintaxis</h2> - -<pre class="syntaxbox">new ArrayBuffer(length) -</pre> - -<h3 id="Parámetros">Parámetros</h3> - -<dl> - <dt><code>length</code></dt> - <dd>El tamaño en bytes, del array buffer que quieres crear.</dd> -</dl> - -<h3 id="Valor_de_retorno">Valor de retorno</h3> - -<p>Un nuevo objeto <code>ArrayBuffer</code> de tamaño específico. Su contenido se inicializa a cero.</p> - -<h3 id="Excepciones">Excepciones</h3> - -<p>Se lanza un {{jsxref("RangeError")}} si la longitud (<code>length</code>) es mayor que {{jsxref("Number.MAX_SAFE_INTEGER")}} (> = 2 ** 53) o negativa.</p> - -<h2 id="Descripción">Descripción</h2> - -<p>El constructor de <code>ArrayBuffer</code> crea un nuevo <code>ArrayBuffer</code> del tamaño especificado en bytes.</p> - -<h3 id="Obtener_un_array_buffer_sobre_datos_existentes">Obtener un array buffer sobre datos existentes</h3> - -<ul> - <li><a href="/es/docs/Web/API/WindowBase64/Base64_encoding_and_decoding#Appendix.3A_Decode_a_Base64_string_to_Uint8Array_or_ArrayBuffer">Desde un string Base64</a></li> - <li><a href="/es/docs/Web/API/FileReader#readAsArrayBuffer()">Desde un fichero local</a></li> -</ul> - -<h2 id="Propiedades">Propiedades</h2> - -<dl> - <dt><code>ArrayBuffer.length</code></dt> - <dd>El tamaño de constructor de <code>ArrayBuffer</code> cuyo valor es 1.</dd> - <dt>{{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}</dt> - <dd>La función de constructor que se usa para crear objetos derivados.</dd> - <dt>{{jsxref("ArrayBuffer.prototype")}}</dt> - <dd>Permite añadir propiedades a todos los objetos <code>ArrayBuffer</code>.</dd> -</dl> - -<h2 id="Métodos">Métodos</h2> - -<dl> - <dt>{{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}}</dt> - <dd>Devuelve <code>true</code> si <code>arg</code> es una de las vistas de ArrayBuffer, como pueden ser los <a href="/es/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">arrays tipados</a> o un {{jsxref("DataView")}}. Sino devuelve <code>false</code>.</dd> - <dt>{{jsxref("ArrayBuffer.transfer", "ArrayBuffer.transfer(oldBuffer [, newByteLength])")}} {{experimental_inline}}</dt> - <dd> - <div class="line" id="file-arraybuffer-transfer-LC6">Devuelve un nuevo <code>ArrayBuffer</code> cuyo contenido se toma de los datos de <code>oldBuffer</code> y luego es truncado o extendido por cero por <code>newByteLength</code>.</div> - </dd> -</dl> - -<h2 id="Instancias">Instancias</h2> - -<p>Todas las instancias de <code>ArrayBuffer</code> heredan de {{jsxref("ArrayBuffer.prototype")}}.</p> - -<h3 id="Propiedades_2">Propiedades</h3> - -<p>{{page('es/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Propiedades')}}</p> - -<h3 id="Métodos_2">Métodos</h3> - -<p>{{page('es/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/prototype','Métodos')}}</p> - -<dl> - <dt>{{jsxref("ArrayBuffer.slice()")}} {{non-standard_inline}}</dt> - <dd>Tiene la misma funcionalidad que {{jsxref("ArrayBuffer.prototype.slice()")}}.</dd> -</dl> - -<h2 id="Ejemplo">Ejemplo</h2> - -<p>En este ejemplo creamos un buffer de 8-bytes con una vista del tipo {{jsxref("Global_Objects/Int32Array", "Int32Array")}} referenciando dicho buffer:</p> - -<pre class="brush: js">var buffer = new ArrayBuffer(8); -var view = new Int32Array(buffer);</pre> - -<h2 id="Especificaciones">Especificaciones</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificación</th> - <th scope="col">Estado</th> - <th scope="col">Comentario</th> - </tr> - <tr> - <td>{{SpecName('Typed Array')}}</td> - <td>{{Spec2('Typed Array')}}</td> - <td>Sustituida por ECMAScript 6.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Definición inicial en un estándar ECMA. Especifica que new es obligatorio.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidad_con_navegadores">Compatibilidad con navegadores</h2> - -<p>{{Compat("javascript.builtins.ArrayBuffer")}}</p> - -<h2 id="Notas_de_compatibilidad">Notas de compatibilidad</h2> - -<p>Desde el ECMAScript 2015, los constructores de <code>ArrayBuffer</code> requieren ser instanciados usando el operador {{jsxref("Operators/new", "new")}}. Ejecutar el constructor de un <code>ArrayBuffer</code> como una funciónsin el <code>new</code>, lanzará un {{jsxref("TypeError")}} de ahora en adelante.</p> - -<pre class="brush: js example-bad">var dv = ArrayBuffer(10); -// TypeError: llamar al constructor ArrayBuffer sin new está prohibido</pre> - -<pre class="brush: js example-good">var dv = new ArrayBuffer(10);</pre> - -<h2 id="Ver_también">Ver también</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Typed_arrays">JavaScript typed arrays</a></li> - <li>{{jsxref("SharedArrayBuffer")}}</li> -</ul> 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(<var>arg</var>)")}} + - : 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) |