diff options
Diffstat (limited to 'files/fr/web/javascript/reference/global_objects/arraybuffer')
5 files changed, 176 insertions, 281 deletions
diff --git a/files/fr/web/javascript/reference/global_objects/arraybuffer/@@species/index.md b/files/fr/web/javascript/reference/global_objects/arraybuffer/@@species/index.md index d86f413799..7a9b7c3e7e 100644 --- a/files/fr/web/javascript/reference/global_objects/arraybuffer/@@species/index.md +++ b/files/fr/web/javascript/reference/global_objects/arraybuffer/@@species/index.md @@ -10,62 +10,48 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer/@@species original_slug: Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/@@species --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La propriété d'accesseur <code><strong>ArrayBuffer[@@species]</strong></code> renvoie le constructeur <code>ArrayBuffer</code>.</p> +La propriété d'accesseur **`ArrayBuffer[@@species]`** renvoie le constructeur `ArrayBuffer`. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">ArrayBuffer[Symbol.species] -</pre> + ArrayBuffer[Symbol.species] -<h2 id="Description">Description</h2> +## Description -<p>L'accesseur <code>species</code> renvoie le constructeur par défaut pour les objets <code>ArrayBuffer</code>. Les constructeurs des sous-classes peuvent surcharger ce symbole pour modifier l'affectation du constructeur.</p> +L'accesseur `species` renvoie le constructeur par défaut pour les objets `ArrayBuffer`. Les constructeurs des sous-classes peuvent surcharger ce symbole pour modifier l'affectation du constructeur. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>La propriété <code>species</code> renvoie le constructeur par défaut, soit <code>ArrayBuffer</code> dans le cas des objets <code>ArrayBuffer</code> :</p> +La propriété `species` renvoie le constructeur par défaut, soit `ArrayBuffer` dans le cas des objets `ArrayBuffer` : -<pre class="brush: js">ArrayBuffer[Symbol.species]; // function ArrayBuffer()</pre> +```js +ArrayBuffer[Symbol.species]; // function ArrayBuffer() +``` -<p>Pour un objet dérivé (par exemple une classe sur mesure <code>MonArrayBuffer</code>), le symbole <code>species</code> renverra le constructeur <code>MonArrayBuffer</code>. Il est possible de surcharger ce comportement pour renvoyer le constructeur <code>ArrayBuffer</code> :</p> +Pour un objet dérivé (par exemple une classe sur mesure `MonArrayBuffer`), le symbole `species` renverra le constructeur `MonArrayBuffer`. Il est possible de surcharger ce comportement pour renvoyer le constructeur `ArrayBuffer` : -<pre class="brush: js">class MonArrayBuffer extends ArrayBuffer { +```js +class MonArrayBuffer extends ArrayBuffer { // On surcharge species pour renvoyer // le constructeur parent ArrayBuffer static get [Symbol.species]() { return ArrayBuffer; } -}</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-get-arraybuffer-@@species', 'get ArrayBuffer [ @@species ]')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-get-arraybuffer-@@species', 'get ArrayBuffer [ @@species ]')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.ArrayBuffer.@@species")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("Symbol.species")}}</li> -</ul> +} +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | -------------------- | +| {{SpecName('ES6', '#sec-get-arraybuffer-@@species', 'get ArrayBuffer [ @@species ]')}} | {{Spec2('ES6')}} | Définition initiale. | +| {{SpecName('ESDraft', '#sec-get-arraybuffer-@@species', 'get ArrayBuffer [ @@species ]')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.ArrayBuffer.@@species")}} + +## Voir aussi + +- {{jsxref("ArrayBuffer")}} +- {{jsxref("Symbol.species")}} diff --git a/files/fr/web/javascript/reference/global_objects/arraybuffer/bytelength/index.md b/files/fr/web/javascript/reference/global_objects/arraybuffer/bytelength/index.md index 8839c62408..5bbc57d6a2 100644 --- a/files/fr/web/javascript/reference/global_objects/arraybuffer/bytelength/index.md +++ b/files/fr/web/javascript/reference/global_objects/arraybuffer/bytelength/index.md @@ -10,59 +10,39 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer/byteLength original_slug: Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/byteLength --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>L'accesseur <code><strong>byteLength</strong></code> est une propriété représentant la longueur d'un {{jsxref("ArrayBuffer")}} en octets.</p> +L'accesseur **`byteLength`** est une propriété représentant la longueur d'un {{jsxref("ArrayBuffer")}} en octets. -<div>{{EmbedInteractiveExample("pages/js/arraybuffer-bytelength.html")}}</div> +{{EmbedInteractiveExample("pages/js/arraybuffer-bytelength.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var>arr</var>aybuffer.byteLength</pre> + arraybuffer.byteLength -<h2 id="Description">Description</h2> +## Description -<p>La propriété <code>byteLength</code> est un accesseur dont le mutateur associé vaut <code>undefined</code>. Cela signifie que cette propriété est en lecture seule. La valeur est déterminée lors de la construction du tableau et ne peut pas être changée par la suite. Cette propriété renvoie 0 si ce <code>ArrayBuffer</code> a été détaché.</p> +La propriété `byteLength` est un accesseur dont le mutateur associé vaut `undefined`. Cela signifie que cette propriété est en lecture seule. La valeur est déterminée lors de la construction du tableau et ne peut pas être changée par la suite. Cette propriété renvoie 0 si ce `ArrayBuffer` a été détaché. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush:js">var buffer = new ArrayBuffer(8); +```js +var buffer = new ArrayBuffer(8); buffer.byteLength; // 8 -</pre> +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('Typed Array')}}</td> - <td>{{Spec2('Typed Array')}}</td> - <td>Remplacée dans ECMAScript 2015.</td> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-get-arraybuffer.prototype.bytelength', 'ArrayBuffer.prototype.byteLength')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Définition initiale au sein d'un standard ECMA.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-get-arraybuffer.prototype.bytelength', 'ArrayBuffer.prototype.byteLength')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaires | +| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------------------------------------------- | +| {{SpecName('Typed Array')}} | {{Spec2('Typed Array')}} | Remplacée dans ECMAScript 2015. | +| {{SpecName('ES2015', '#sec-get-arraybuffer.prototype.bytelength', 'ArrayBuffer.prototype.byteLength')}} | {{Spec2('ES2015')}} | Définition initiale au sein d'un standard ECMA. | +| {{SpecName('ESDraft', '#sec-get-arraybuffer.prototype.bytelength', 'ArrayBuffer.prototype.byteLength')}} | {{Spec2('ESDraft')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.ArrayBuffer.byteLength")}}</p> +{{Compat("javascript.builtins.ArrayBuffer.byteLength")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{jsxref("ArrayBuffer")}}</li> -</ul> +- {{jsxref("ArrayBuffer")}} diff --git a/files/fr/web/javascript/reference/global_objects/arraybuffer/index.md b/files/fr/web/javascript/reference/global_objects/arraybuffer/index.md index 7c46a860de..df2c70beba 100644 --- a/files/fr/web/javascript/reference/global_objects/arraybuffer/index.md +++ b/files/fr/web/javascript/reference/global_objects/arraybuffer/index.md @@ -10,133 +10,105 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer original_slug: Web/JavaScript/Reference/Objets_globaux/ArrayBuffer --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>L'objet <strong><code>ArrayBuffer</code></strong> est utilisé afin de représenter un tampon (<em>buffer</em>) de données binaires de longueur fixe de façon générique. C'est un tableau d'octets. La manipulation du contenu d'un <code>ArrayBuffer</code> se fait de façon indirecte en créant un <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/TypedArray">tableau typé</a> ou un objet {{jsxref("DataView")}} qui permet de représenter le tampon dans un format donné qui permet de lire/écrire des contenus dans le tampon de mémoire.</p> +L'objet **`ArrayBuffer`** est utilisé afin de représenter un tampon (_buffer_) de données binaires de longueur fixe de façon générique. C'est un tableau d'octets. La manipulation du contenu d'un `ArrayBuffer` se fait de façon indirecte en créant un [tableau typé](/fr/docs/Web/JavaScript/Reference/Objets_globaux/TypedArray) ou un objet {{jsxref("DataView")}} qui permet de représenter le tampon dans un format donné qui permet de lire/écrire des contenus dans le tampon de mémoire. -<div>{{EmbedInteractiveExample("pages/js/arraybuffer-constructor.html")}}</div> +{{EmbedInteractiveExample("pages/js/arraybuffer-constructor.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">new ArrayBuffer(longueur) -</pre> + new ArrayBuffer(longueur) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>longueur</code></dt> - <dd>La taille, exprimée en octets, du tableau représentant le tampon.</dd> -</dl> +- `longueur` + - : La taille, exprimée en octets, du tableau représentant le tampon. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un nouvel objet <code>ArrayBuffer</code> de la taille donnée. Ses éléments sont initialisés à 0.</p> +Un nouvel objet `ArrayBuffer` de la taille donnée. Ses éléments sont initialisés à 0. -<h3 id="Exceptions">Exceptions</h3> +### Exceptions -<p>Une exception {{jsxref("RangeError")}} est levée lorsque l'argument <code>longueur</code> est supérieur à {{jsxref("Number.MAX_SAFE_INTEGER")}} (soit 2^53) ou s'il est négatif.</p> +Une exception {{jsxref("RangeError")}} est levée lorsque l'argument `longueur` est supérieur à {{jsxref("Number.MAX_SAFE_INTEGER")}} (soit 2^53) ou s'il est négatif. -<h2 id="Description">Description</h2> +## Description -<p>Le constructeur <code>ArrayBuffer</code> crée une nouvelle instance d'<code>ArrayBuffer</code> dont la longueur est celle donnée lors de la construction.</p> +Le constructeur `ArrayBuffer` crée une nouvelle instance d'`ArrayBuffer` dont la longueur est celle donnée lors de la construction. -<h3 id="Obtenir_un_tampon_mémoire_depuis_des_données_existantes">Obtenir un tampon mémoire depuis des données existantes</h3> +### Obtenir un tampon mémoire depuis des données existantes -<ul> - <li><a href="/fr/docs/Décoder_encoder_en_base64#Annexe_.3A_D.C3.A9coder_une_cha.C3.AEne_en_base64_en_un_objet_Uint8Array_ou_ArrayBuffer">À partir d'une chaîne de caractères en Base 64</a></li> - <li><a href="/fr/docs/Web/API/FileReader">À partir d'un fichier local</a></li> -</ul> +- [À partir d'une chaîne de caractères en Base 64](/fr/docs/Décoder_encoder_en_base64#Annexe_.3A_D.C3.A9coder_une_cha.C3.AEne_en_base64_en_un_objet_Uint8Array_ou_ArrayBuffer) +- [À partir d'un fichier local](/fr/docs/Web/API/FileReader) -<h2 id="Propriétés">Propriétés</h2> +## Propriétés -<dl> - <dt><code>ArrayBuffer.length</code></dt> - <dd>La longueur du constructeur <code>ArrayBuffer</code>. Elle vaut 1.</dd> - <dt>{{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}}</dt> - <dd>La fonction de construction utilisée pour créer les objets dérivés.</dd> - <dt>{{jsxref("ArrayBuffer.prototype")}}</dt> - <dd>Cette propriété permet d'ajouter des propriétés à tous les objets <code>ArrayBuffer</code>.</dd> -</dl> +- `ArrayBuffer.length` + - : La longueur du constructeur `ArrayBuffer`. Elle vaut 1. +- {{jsxref("ArrayBuffer.@@species", "get ArrayBuffer[@@species]")}} + - : La fonction de construction utilisée pour créer les objets dérivés. +- {{jsxref("ArrayBuffer.prototype")}} + - : Cette propriété permet d'ajouter des propriétés à tous les objets `ArrayBuffer`. -<h2 id="Méthodes">Méthodes</h2> +## Méthodes -<dl> - <dt>{{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}}</dt> - <dd>Cette méthode renvoie <code>true</code> si <code>arg</code> est une des vues sur l'<code>ArrayBuffer</code> telle qu'un <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/TypedArray">tableau typé</a> ou un objet {{jsxref("DataView")}}, sinon elle renvoie <code>false</code>.</dd> - <dt>{{jsxref("ArrayBuffer.transfer", "ArrayBuffer.transfer(ancienTampon [, nouvelleLongueur])")}} {{experimental_inline}}</dt> - <dd> - <div>Cette méthode renvoie un nouvel objet <code>ArrayBuffer</code> dont le contenu est transféré depuis les données de <code>ancienTampon</code> et qui est ensuite tronqué ou rallongé avec des zéros pour que la taille du nouveau tampon soit <code>nouvelleLongueur</code>.</div> - </dd> -</dl> +- {{jsxref("ArrayBuffer.isView", "ArrayBuffer.isView(arg)")}} + - : Cette méthode renvoie `true` si `arg` est une des vues sur l'`ArrayBuffer` telle qu'un [tableau typé](/fr/docs/Web/JavaScript/Reference/Objets_globaux/TypedArray) ou un objet {{jsxref("DataView")}}, sinon elle renvoie `false`. +- {{jsxref("ArrayBuffer.transfer", "ArrayBuffer.transfer(ancienTampon [, nouvelleLongueur])")}} {{experimental_inline}} + - : Cette méthode renvoie un nouvel objet `ArrayBuffer` dont le contenu est transféré depuis les données de `ancienTampon` et qui est ensuite tronqué ou rallongé avec des zéros pour que la taille du nouveau tampon soit `nouvelleLongueur`. -<h2 id="Les_instances_d'ArrayBuffer">Les instances d'<code>ArrayBuffer</code></h2> +## Les instances d'`ArrayBuffer` -<p>Toutes les instances d'<code>ArrayBuffer</code> héritent de {{jsxref("ArrayBuffer.prototype")}}.</p> +Toutes les instances d'`ArrayBuffer` héritent de {{jsxref("ArrayBuffer.prototype")}}. -<h3 id="Propriétés_2">Propriétés</h3> +### Propriétés -<p>{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/prototype','Propri.C3.A9t.C3.A9s')}}</p> +{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/prototype','Propri.C3.A9t.C3.A9s')}} -<h3 id="Méthodes_2">Méthodes</h3> +### Méthodes -<p>{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/prototype','M.C3.A9thodes')}}</p> +{{page('fr/docs/Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/prototype','M.C3.A9thodes')}} -<dl> - <dt>{{jsxref("ArrayBuffer.slice()")}} {{non-standard_inline}}</dt> - <dd>Cette méthode fournit la même fonctionnalité que {{jsxref("ArrayBuffer.prototype.slice()")}}.</dd> -</dl> +- {{jsxref("ArrayBuffer.slice()")}} {{non-standard_inline}} + - : Cette méthode fournit la même fonctionnalité que {{jsxref("ArrayBuffer.prototype.slice()")}}. -<h2 id="Exemple">Exemple</h2> +## Exemple -<p>Dans cet exemple, on crée un tampon sur 8 octets avec une vue {{jsxref("Int32Array")}} qui fait référence à ce tampon :</p> +Dans cet exemple, on crée un tampon sur 8 octets avec une vue {{jsxref("Int32Array")}} qui fait référence à ce tampon : -<pre class="brush: js">var tampon = new ArrayBuffer(8); -var vue = new Int32Array(tampon);</pre> +```js +var tampon = new ArrayBuffer(8); +var vue = new Int32Array(tampon); +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('Typed Array')}}</td> - <td>{{Spec2('Typed Array')}}</td> - <td>Remplacée par ECMAScript 6.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Définition initiale au sein d'un standard ECMA. <code>new</code> est obligaoire pour utiliser le constructeur.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-arraybuffer-constructor', 'ArrayBuffer')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> +| Spécification | État | Commentaires | +| -------------------------------------------------------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------- | +| {{SpecName('Typed Array')}} | {{Spec2('Typed Array')}} | Remplacée par ECMAScript 6. | +| {{SpecName('ES6', '#sec-arraybuffer-constructor', 'ArrayBuffer')}} | {{Spec2('ES6')}} | Définition initiale au sein d'un standard ECMA. `new` est obligaoire pour utiliser le constructeur. | +| {{SpecName('ESDraft', '#sec-arraybuffer-constructor', 'ArrayBuffer')}} | {{Spec2('ESDraft')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.ArrayBuffer")}}</p> +{{Compat("javascript.builtins.ArrayBuffer")}} -<h2 id="Notes_de_compatibilité">Notes de compatibilité</h2> +## Notes de compatibilité -<p>À partir d'ECMAScript 2015 (ES6),<code> ArrayBuffer</code> doit être utilisée avec {{jsxref("Opérateurs/L_opérateur_new", "new")}}. Appeler un constructeur <code>ArrayBuffer</code> comme une fonction, sans <code>new</code>, provoquera une exception {{jsxref("TypeError")}}.</p> +À partir d'ECMAScript 2015 (ES6),` ArrayBuffer` doit être utilisée avec {{jsxref("Opérateurs/L_opérateur_new", "new")}}. Appeler un constructeur `ArrayBuffer` comme une fonction, sans `new`, provoquera une exception {{jsxref("TypeError")}}. -<pre class="brush: js example-bad">var dv = ArrayBuffer(10); +```js example-bad +var dv = ArrayBuffer(10); // TypeError: calling a builtin ArrayBuffer constructor -// without new is forbidden</pre> +// without new is forbidden +``` -<pre class="brush: js example-good">var dv = new ArrayBuffer(10);</pre> +```js example-good +var dv = new ArrayBuffer(10); +``` -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/JavaScript/Tableaux_typés">Les tableaux typés JavaScript</a></li> - <li>{{jsxref("SharedArrayBuffer")}}</li> -</ul> +- [Les tableaux typés JavaScript](/fr/docs/Web/JavaScript/Tableaux_typés) +- {{jsxref("SharedArrayBuffer")}} diff --git a/files/fr/web/javascript/reference/global_objects/arraybuffer/isview/index.md b/files/fr/web/javascript/reference/global_objects/arraybuffer/isview/index.md index 876fdd595b..d5224cac4c 100644 --- a/files/fr/web/javascript/reference/global_objects/arraybuffer/isview/index.md +++ b/files/fr/web/javascript/reference/global_objects/arraybuffer/isview/index.md @@ -10,30 +10,29 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer/isView original_slug: Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/isView --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>ArrayBuffer.isView()</strong></code> renvoie <code>true</code> si l'argument passé est une des vues <code>ArrayBuffer</code>, comme par exemple <a href="/fr/docs/Web/JavaScript/Reference/Objets_globaux/TypedArray">un tableau typé</a> ou une {{jsxref("DataView")}} ; <code>false</code> sinon.</p> +La méthode **`ArrayBuffer.isView()`** renvoie `true` si l'argument passé est une des vues `ArrayBuffer`, comme par exemple [un tableau typé](/fr/docs/Web/JavaScript/Reference/Objets_globaux/TypedArray) ou une {{jsxref("DataView")}} ; `false` sinon. -<div>{{EmbedInteractiveExample("pages/js/arraybuffer-isview.html")}}</div> +{{EmbedInteractiveExample("pages/js/arraybuffer-isview.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">ArrayBuffer.isView(<var>arg</var>)</pre> + ArrayBuffer.isView(arg) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>arg</code></dt> - <dd>L'argument dont on souhaite savoir s'il est une vue.</dd> -</dl> +- `arg` + - : L'argument dont on souhaite savoir s'il est une vue. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p><code>true</code> si la valeur passée en argument est une des vues du tableau <code>ArrayBuffer</code>, <code>false</code> sinon.</p> +`true` si la valeur passée en argument est une des vues du tableau `ArrayBuffer`, `false` sinon. -<h2 id="Exemples">Exemples</h2> +## Exemples -<pre class="brush: js">ArrayBuffer.isView(); // false +```js +ArrayBuffer.isView(); // false ArrayBuffer.isView([]); // false ArrayBuffer.isView({}); // false ArrayBuffer.isView(null); // false @@ -47,41 +46,20 @@ ArrayBuffer.isView(new Int8Array(10).subarray(0, 3)); // true var buffer = new ArrayBuffer(2); var dv = new DataView(buffer); ArrayBuffer.isView(dv); // true -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">État</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('Typed Array')}}</td> - <td>{{Spec2('Typed Array')}}</td> - <td>Remplacée par ECMAScript 2015</td> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-arraybuffer.isview', 'ArrayBuffer.isView')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Définition initiale dans un standard ECMA.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-arraybuffer.isview', 'ArrayBuffer.isView')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("javascript.builtins.ArrayBuffer.isView")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li><a href="/fr/docs/Web/JavaScript/Tableaux_typés">Les tableaux typés en JavaScript</a></li> -</ul> +``` + +## Spécifications + +| Spécification | État | Commentaires | +| ------------------------------------------------------------------------------------------------ | -------------------------------- | ------------------------------------------ | +| {{SpecName('Typed Array')}} | {{Spec2('Typed Array')}} | Remplacée par ECMAScript 2015 | +| {{SpecName('ES2015', '#sec-arraybuffer.isview', 'ArrayBuffer.isView')}} | {{Spec2('ES2015')}} | Définition initiale dans un standard ECMA. | +| {{SpecName('ESDraft', '#sec-arraybuffer.isview', 'ArrayBuffer.isView')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.ArrayBuffer.isView")}} + +## Voir aussi + +- [Les tableaux typés en JavaScript](/fr/docs/Web/JavaScript/Tableaux_typés) diff --git a/files/fr/web/javascript/reference/global_objects/arraybuffer/slice/index.md b/files/fr/web/javascript/reference/global_objects/arraybuffer/slice/index.md index e52b95fd86..e776d858bb 100644 --- a/files/fr/web/javascript/reference/global_objects/arraybuffer/slice/index.md +++ b/files/fr/web/javascript/reference/global_objects/arraybuffer/slice/index.md @@ -10,73 +10,52 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/ArrayBuffer/slice original_slug: Web/JavaScript/Reference/Objets_globaux/ArrayBuffer/slice --- -<div>{{JSRef}}</div> +{{JSRef}} -<p>La méthode <code><strong>slice()</strong></code> renvoie un nouvel <code>ArrayBuffer</code> dont le contenu est une copie des octets du <code>ArrayBuffer</code> courant, contenus entre <code>début</code> (compris) et <code>fin</code> (non-compris).</p> +La méthode **`slice()`** renvoie un nouvel `ArrayBuffer` dont le contenu est une copie des octets du `ArrayBuffer` courant, contenus entre `début` (compris) et `fin` (non-compris). -<div>{{EmbedInteractiveExample("pages/js/arraybuffer-slice.html")}}</div> +{{EmbedInteractiveExample("pages/js/arraybuffer-slice.html")}} -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox">arraybuffer.slice(début[, fin])</pre> + arraybuffer.slice(début[, fin]) -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>début</code></dt> - <dd>Indice (numérotation commençant à zéro) de l'octet à partir duquel découper le tableau.</dd> - <dt><code>fin</code></dt> - <dd>Indice de l'octet auquel finir la découpe du tableau. Si ce paramètre n'est pas fourni, le nouvel <code>ArrayBuffer</code> contiendra tous les octets entre <code>début </code>et la fin du <code>ArrayBuffer</code> courant. L'intervalle défini par les valeurs <code>début</code> et <code>fin</code> est réduit à un intervalle valide pour le tableau courant si nécessaire. Si la longueur du nouveau tableau <code>ArrayBuffer</code> sera négative, l'intervalle est réduit à zéro.</dd> -</dl> +- `début` + - : Indice (numérotation commençant à zéro) de l'octet à partir duquel découper le tableau. +- `fin` + - : Indice de l'octet auquel finir la découpe du tableau. Si ce paramètre n'est pas fourni, le nouvel `ArrayBuffer` contiendra tous les octets entre `début `et la fin du `ArrayBuffer` courant. L'intervalle défini par les valeurs `début` et `fin` est réduit à un intervalle valide pour le tableau courant si nécessaire. Si la longueur du nouveau tableau `ArrayBuffer` sera négative, l'intervalle est réduit à zéro. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +### Valeur de retour -<p>Un nouvel objet <code>ArrayBuffer</code>.</p> +Un nouvel objet `ArrayBuffer`. -<h2 id="Description">Description</h2> +## Description -<p>La méthode <code>slice</code> copie les octets contenus jusqu'au (au sens exclusif) paramètre <code>fin</code>. Si le paramètre <code>début </code>ou <code>fin</code> est négatif, il fera référence à l'indice à partir de la fin du tableau et non pas à l'indice à partir du début du tableau.</p> +La méthode `slice` copie les octets contenus jusqu'au (au sens exclusif) paramètre `fin`. Si le paramètre `début `ou `fin` est négatif, il fera référence à l'indice à partir de la fin du tableau et non pas à l'indice à partir du début du tableau. -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Copier_un_ArrayBuffer">Copier un <code>ArrayBuffer</code></h3> +### Copier un `ArrayBuffer` -<pre class="brush: js">var buf1 = new ArrayBuffer(8); -var buf2 = buf1.slice(0)</pre> +```js +var buf1 = new ArrayBuffer(8); +var buf2 = buf1.slice(0) +``` -<h2 id="Spécifications">Spécifications</h2> +## Spécifications -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaires</th> - </tr> - <tr> - <td>{{SpecName('Typed Array')}}</td> - <td>{{Spec2('Typed Array')}}</td> - <td>Remplacée dans EMCAScript 6.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-arraybuffer.prototype.slice', 'ArrayBuffer.prototype.slice')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Définition initiale au sein d'un standard ECMA.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-arraybuffer.prototype.slice', 'ArrayBuffer.prototype.slice')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> +| Spécification | Statut | Commentaires | +| ------------------------------------------------------------------------------------------------------------------------ | -------------------------------- | ----------------------------------------------- | +| {{SpecName('Typed Array')}} | {{Spec2('Typed Array')}} | Remplacée dans EMCAScript 6. | +| {{SpecName('ES6', '#sec-arraybuffer.prototype.slice', 'ArrayBuffer.prototype.slice')}} | {{Spec2('ES6')}} | Définition initiale au sein d'un standard ECMA. | +| {{SpecName('ESDraft', '#sec-arraybuffer.prototype.slice', 'ArrayBuffer.prototype.slice')}} | {{Spec2('ESDraft')}} | | -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> +## Compatibilité des navigateurs -<p>{{Compat("javascript.builtins.ArrayBuffer.slice")}}</p> +{{Compat("javascript.builtins.ArrayBuffer.slice")}} -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li>{{jsxref("ArrayBuffer")}}</li> -</ul> +- {{jsxref("ArrayBuffer")}} |