From 39f2114f9797eb51994966c6bb8ff1814c9a4da8 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 12:36:08 +0100 Subject: unslug fr: move --- .../sharedarraybuffer/bytelength/index.html | 62 ++++++++++ .../global_objects/sharedarraybuffer/index.html | 135 +++++++++++++++++++++ .../sharedarraybuffer/slice/index.html | 92 ++++++++++++++ 3 files changed, 289 insertions(+) create mode 100644 files/fr/web/javascript/reference/global_objects/sharedarraybuffer/bytelength/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/sharedarraybuffer/index.html create mode 100644 files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html (limited to 'files/fr/web/javascript/reference/global_objects/sharedarraybuffer') diff --git a/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/bytelength/index.html b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/bytelength/index.html new file mode 100644 index 0000000000..d05477184d --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/bytelength/index.html @@ -0,0 +1,62 @@ +--- +title: SharedArrayBuffer.prototype.byteLength +slug: Web/JavaScript/Reference/Objets_globaux/SharedArrayBuffer/byteLength +tags: + - JavaScript + - Mémoire partagée + - Propriété + - Reference + - SharedArrayBuffer + - TypedArrays +translation_of: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/byteLength +--- +
{{JSRef}}
+ +

La propriété d'accesseur byteLength représente la longueur d'un {{jsxref("SharedArrayBuffer")}} exprimée en octets.

+ +
{{EmbedInteractiveExample("pages/js/sharedarraybuffer-bytelength.html")}}
+ + + +

Syntaxe

+ +
sab.byteLength
+ +

Description

+ +

La propriété byteLength est une propriété d'accesseur dont le mutateur associé vaut undefined. Autrement dit, cette propriété est en lecture seule. La valeur est établie lorsque le tableau partagé est construit et elle ne peut être modifiée par la suite.

+ +

Exemples

+ +
var sab = new SharedArrayBuffer(1024);
+sab.byteLength; // 1024
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaires
{{SpecName('ESDraft', '#sec-get-sharedarraybuffer.prototype.bytelength', 'SharedArrayBuffer.prototype.byteLength')}}{{Spec2('ESDraft')}}Définition initiale avec ES2017.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("javascript.builtins.SharedArrayBuffer.byteLength")}}

+ +

Voir aussi

+ + diff --git a/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/index.html b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/index.html new file mode 100644 index 0000000000..b5c3a36e27 --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/index.html @@ -0,0 +1,135 @@ +--- +title: SharedArrayBuffer +slug: Web/JavaScript/Reference/Objets_globaux/SharedArrayBuffer +tags: + - Constructeur + - JavaScript + - Mémoire partagée + - Reference + - SharedArrayBuffer + - TypedArrays +translation_of: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer +--- +
{{JSRef}}
+ +

L'objet SharedArrayBuffer est utilisé afin de représenter un tampon de données binaires brutes générique de longueur fixe. Il est semblable à l'objet {{jsxref("ArrayBuffer")}} mais peut ici être utilisé pour créer différentes vues sur une même mémoire partagée. À la différence d'un ArrayBuffer, un SharedArrayBuffer ne peut pas être détaché.

+ +
+

Note : L'objet SharedArrayBuffer a été désactivé le 5 janvier 2018 par défaut pour l'ensemble des principaux navigateurs afin de réduire les failles Meltdown et Spectre. Chrome a réactivé cet objet avec la version 67 pour les plateformes sur lesquelles des fonctionnalités sont présentes pour protéger des vulnérabilités telles que Spectre (« site-isolation feature »)

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

Syntaxe

+ + +
new SharedArrayBuffer([length])
+
+ +

Paramètres

+ +
+
longueur
+
La taille, exprimée en octets, du tampon (buffer) de données qu'on souhaite créer.
+
+ +

Valeur de retour

+ +

Un nouvel objet SharedArrayBuffer de la taille donnée, dont les éléments sont initialisés à 0.

+ +

Description

+ +

Allouer et partager la mémoire

+ +

Pour partager une zone mémoire entre plusieurs objets {{jsxref("SharedArrayBuffer")}} d'un agent à un autre (ici un agent correspond au programme principal de la page web ou à l'un de ses web workers), on utilise postMessage et le clonage structuré.

+ +

L'algorithme de clonage structuré permet d'envoyer des objets SharedArrayBuffers et TypedArrays vers SharedArrayBuffers. Dans les deux cas, l'objet SharedArrayBuffer est transmis au récepteur, ce qui crée un nouvel objet SharedArrayBuffer, privé, au sein de l'agent qui reçoit (comme avec  {{jsxref("ArrayBuffer")}}). Cependant, le bloc de mémoire référencé par les deux objets SharedArrayBuffer est bien le même bloc. Aussi, si un agent interagit avec cette zone, l'autre agent pourra voir les modifications.

+ +
var sab = new SharedArrayBuffer(1024);
+worker.postMessage(sab);
+
+ +

Mettre à jour et synchroniser la mémoire partagée avec les opérations atomiques

+ +

La mémoire partagée peut être créée et mise à jour de façon simultanée entre les workers et le thread d'exécution principal. Selon le système (le processeur, le système d'exploitation, le navigateur), cela peut prendre du temps avant que le changement soit propagé sur l'ensemble des contextes. Pour que la synchronisation s'effectue, on doit utiliser les opérations {{jsxref("Atomics", "atomiques", "", 1)}}.

+ +

Les API qui utilisent des objets SharedArrayBuffer

+ + + +

Obligation d'utiliser l'opérateur new

+ +

Les constructeurs SharedArrayBuffer doivent être utilisés avec l'opérateur {{jsxref("Opérateurs/L_opérateur_new", "new")}}. Si on appelle un constructeur SharedArrayBuffer comme une fonction, sans new, cela lèvera une exception {{jsxref("TypeError")}}.

+ +
var sab = SharedArrayBuffer(1024);
+// TypeError: appeler le constructeur natif SharedArrayBuffer sans
+// new est interdit
+ +
var sab = new SharedArrayBuffer(1024);
+ +

Propriétés

+ +
+
SharedArrayBuffer.length
+
La propriété de longueur pour le constructeur SharedArrayBuffer dont la valeur est 1.
+
{{jsxref("SharedArrayBuffer.prototype")}}
+
Le prototype permet d'ajouter des propriétés à l'ensemble des objets SharedArrayBuffer.
+
+ +

Le prototype de SharedArrayBuffer

+ +

Toutes les instances de SharedArrayBuffer héritent de {{jsxref("SharedArrayBuffer.prototype")}}.

+ +

Propriétés

+ +

{{page('fr/Web/JavaScript/Reference/Objets_globaux/SharedArrayBuffer/prototype','Propriétés')}}

+ +

Méthodes

+ +

{{page('fr/Web/JavaScript/Reference/Objets_globaux/SharedArrayBuffer/prototype','Méthodes')}}

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('ESDraft', '#sec-sharedarraybuffer-objects', 'SharedArrayBuffer')}}{{Spec2('ESDraft')}}
{{SpecName('ES8', '#sec-sharedarraybuffer-objects', 'SharedArrayBuffer')}}{{Spec2('ES8')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ + + +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html new file mode 100644 index 0000000000..3bf6abe8af --- /dev/null +++ b/files/fr/web/javascript/reference/global_objects/sharedarraybuffer/slice/index.html @@ -0,0 +1,92 @@ +--- +title: SharedArrayBuffer.prototype.slice() +slug: Web/JavaScript/Reference/Objets_globaux/SharedArrayBuffer/slice +tags: + - JavaScript + - Mémoire partagée + - Méthode + - Prototype + - Reference + - SharedArrayBuffer + - TypedArrays +translation_of: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/slice +--- +
{{JSRef}}
+ +

La méthode SharedArrayBuffer.prototype.slice() renvoie un nouvel objet {{jsxref("SharedArrayBuffer")}} dont le contenu est une copie des octets de l'objet SharedArrayBuffer courant entre un indice de début (inclus) et un indice de fin (exclus) (autrement dit, on copie une « tranche » du tampon courant). Si l'indice de début ou de fin est négatif, la position sera comptée à partir de la fin du tableau plutôt qu'à partir du début. L'algorithme appliqué est le même que {{jsxref("Array.prototype.slice()")}}.

+ +
{{EmbedInteractiveExample("pages/js/sharedarraybuffer-slice.html")}}
+ + + +

Syntaxe

+ +
sab.slice()
+sab.slice(début)
+sab.slice(début, fin)
+ +

Paramètres

+ +
+
début {{optional_inline}}
+
+

L'indice auquel commencer l'extraction (le début du tableau se situe à l'indice 0).

+ +

Si la valeur est négative, début indique le décalage à partir de la fin du tableau. Ainsi slice(-2) permettra d'extraire les deux derniers éléments du tableau.

+ +

Si début est absent, slice commencera l'extraction à partir de l'indice 0.

+
+
fin {{optional_inline}}
+
+

L'indice auquel finir l'extraction. Attention, la valeur du tableau pour cet indice n'est pas incluse dans l'extraction.

+ +

Ainsi, slice(1,4) permettra d'extraire entre le deuxième et le quatrième élément (c'est-à-dire les trois éléments dont les indices sont respectivement 1, 2 et 3).

+ +

Si fin est un indice négatif, il indique le décalage à partir de la fin du tableau. Autrement dit slice(2,-1) permettra d'extraire les éléments du tampon à partir du troisième élément et jusqu'à l'avant-avant-dernier élément.

+ +

Si fin est absent, slice réalisera l'extraction jusqu'à la fin de la séquence (sab.byteLength).

+
+
+ +

Valeur de retour

+ +

Un nouvel objet {{jsxref("SharedArrayBuffer")}} qui contient les éléments extraits.

+ +

Exemples

+ +
var sab = new SharedArrayBuffer(1024);
+sab.slice();    // SharedArrayBuffer { byteLength: 1024 }
+sab.slice(2);   // SharedArrayBuffer { byteLength: 1022 }
+sab.slice(-2);  // SharedArrayBuffer { byteLength: 2 }
+sab.slice(0,1); // SharedArrayBuffer { byteLength: 1 }
+
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationÉtatCommentaires
{{SpecName('ESDraft', '#sec-sharedarraybuffer.prototype.slice', 'SharedArrayBuffer.prototype.slice')}}{{Spec2('ESDraft')}}Définition initiale avec ES2017.
+ +

Compatibilité des navigateurs

+ + + +

{{Compat("javascript.builtins.SharedArrayBuffer.slice")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf