diff options
author | Florian Merz <me@fiji-flo.de> | 2021-02-11 12:36:08 +0100 |
---|---|---|
committer | Florian Merz <me@fiji-flo.de> | 2021-02-11 12:36:08 +0100 |
commit | 39f2114f9797eb51994966c6bb8ff1814c9a4da8 (patch) | |
tree | 66dbd9c921f56e440f8816ed29ac23682a1ac4ef /files/fr/orphaned/web/javascript | |
parent | 8260a606c143e6b55a467edf017a56bdcd6cba7e (diff) | |
download | translated-content-39f2114f9797eb51994966c6bb8ff1814c9a4da8.tar.gz translated-content-39f2114f9797eb51994966c6bb8ff1814c9a4da8.tar.bz2 translated-content-39f2114f9797eb51994966c6bb8ff1814c9a4da8.zip |
unslug fr: move
Diffstat (limited to 'files/fr/orphaned/web/javascript')
3 files changed, 305 insertions, 0 deletions
diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/array/prototype/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/array/prototype/index.html new file mode 100644 index 0000000000..cb423c22f3 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/array/prototype/index.html @@ -0,0 +1,181 @@ +--- +title: Array.prototype +slug: Web/JavaScript/Reference/Objets_globaux/Array/prototype +tags: + - Array + - JavaScript + - Propriété + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/Array/prototype +--- +<div>{{JSRef}}</div> + +<p>La propriété <strong><code>Array.prototype</code></strong> représente le prototype du constructeur {{jsxref("Array")}} et permet d'ajouter de nouvelles propriétés à l'ensemble des objets <code>Array</code>.</p> + +<h2 id="Description">Description</h2> + +<p>Les instances d'<code>Array</code> héritent de <code>Array.prototype</code>. Comme pour tous les constructeurs, vous pouvez changer l'objet prototype du constructeur afin de modifier toutes les instances d'<code>Array</code>. On peut utiliser cette méthode afin de réaliser des prothèses/<em>polyfills</em>.</p> + +<p>Toutefois, si on utilise le prototype pour ajouter des méthodes ou propriétés non-standards à <code>Array</code>, cela peut entraîner certains problèmes au sein de votre code ou lors de l'<a href="https://developers.google.com/web/updates/2018/03/smooshgate">ajout de fonctionnalités à JavaScript</a>.</p> + +<p>Fait peu connu : <code>Array.prototype</code> est lui-même un objet {{jsxref("Array")}} :</p> + +<pre class="brush: js">Array.isArray(Array.prototype); // true</pre> + +<p>{{js_property_attributes(0,0,0)}}</p> + +<h2 id="Propriétés">Propriétés</h2> + +<dl> + <dt>Array.prototype.constructor</dt> + <dd>Cette propriété définit la fonction qui crée le prototype d'un objet.</dd> + <dt>{{jsxref("Array.prototype.length")}}</dt> + <dd>Cette propriété renvoie le nombre d'éléments d'un tableau.</dd> + <dt>{{jsxref("Array.@@unscopables", "Array.prototype[@@unscopables]")}}</dt> + <dd>Un symbole contenant les noms des propriétés à exclure lors d'une liaison effectuée avec <code><a href="/fr/docs/Web/JavaScript/Reference/Instructions/with">with</a></code>.</dd> +</dl> + +<h2 id="Méthodes">Méthodes</h2> + +<h3 id="Mutateurs">Mutateurs</h3> + +<p>Ces méthodes modifient le tableau :</p> + +<dl> + <dt>{{jsxref("Array.prototype.copyWithin()")}}</dt> + <dd>Cette méthode copie une série d'éléments de tableau dans le tableau.</dd> + <dt>{{jsxref("Array.prototype.fill()")}}</dt> + <dd>Cette méthode remplie tous les éléments d'un tableau avec une même valeur, éventuellement entre un indice de début et un indice de fin.</dd> +</dl> + +<dl> + <dt>{{jsxref("Array.prototype.pop()")}}</dt> + <dd>Cette méthode supprime le dernier élément d'un tableau et retourne cet élément.</dd> + <dt>{{jsxref("Array.prototype.push()")}}</dt> + <dd>Cette méthode ajoute un ou plusieurs éléments à la fin d'un tableau et retourne la nouvelle longueur du tableau.</dd> + <dt>{{jsxref("Array.prototype.reverse()")}}</dt> + <dd>Cette méthode renverse l'ordre des éléments d'un tableau - le premier élément devient le dernier, et le dernier devient le premier. Le tableau est modifié par cette méthode.</dd> + <dt>{{jsxref("Array.prototype.shift()")}}</dt> + <dd>Cette méthode supprime le premier élément d'un tableau et retourne cet élément.</dd> + <dt>{{jsxref("Array.prototype.sort()")}}</dt> + <dd>Cette méthode trie en place les éléments d'un tableau et retourne le tableau.</dd> + <dt>{{jsxref("Array.prototype.splice()")}}</dt> + <dd>Cette méthode permet d'ajouter ou de retirer des éléments d'un tableau.</dd> + <dt>{{jsxref("Array.prototype.unshift()")}}</dt> + <dd>Cette méthode permet d'ajouter un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.</dd> +</dl> + +<h3 id="Accesseurs">Accesseurs</h3> + +<p>Ces méthodes ne modifient pas l'état du tableau et en retournent une représentation.</p> + +<dl> + <dt>{{jsxref("Array.prototype.concat()")}}</dt> + <dd>Cette méthode renvoie un nouveau tableau constitué de ce tableau concaténé avec un ou plusieurs autre(s) tableau(x) et/ou valeur(s).</dd> + <dt>{{jsxref("Array.prototype.includes()")}}</dt> + <dd>Cette méthode détermine si le tableau contient ou non un certain élément. Elle renvoie <code>true</code> ou <code>false</code> selon le cas de figure.</dd> + <dt>{{jsxref("Array.prototype.indexOf()")}}</dt> + <dd>Cette méthode retourne le premier (plus petit) index d'un élément égal à la valeur passée en paramètre à l'intérieur du tableau, ou -1 si aucun n'a été trouvé.</dd> + <dt>{{jsxref("Array.prototype.join()")}}</dt> + <dd>Cette méthode concatène tous les éléments d'un tableau en une chaîne de caractères.</dd> + <dt>{{jsxref("Array.prototype.lastIndexOf()")}}</dt> + <dd>Cette méthode retourne le dernier (plus grand) index d'un élément égal à la valeur passée en paramètre à l'intérieur du tableau, ou -1 si aucun n'a été trouvé.</dd> + <dt>{{jsxref("Array.prototype.slice()")}}</dt> + <dd>Cette méthode extrait une portion d'un tableau pour retourner un nouveau tableau constitué de ces éléments.</dd> + <dt>{{jsxref("Array.prototype.toSource()")}} {{Non-standard_inline()}}</dt> + <dd>Cette méthode renvoie la représentation littérale du tableau spécifié ; vous pouvez utiliser cette valeur pour créer un nouveau tableau. Elle redéfinit la méthode {{jsxref("Object.prototype.toSource()")}}.</dd> + <dt>{{jsxref("Array.prototype.toString()")}}</dt> + <dd>Cette méthode renvoie une chaîne de caractères représentant le tableau et ses éléments. Elle redéfinit la méthode {{jsxref("Object.prototype.toString()")}}.</dd> + <dt>{{jsxref("Array.prototype.toLocaleString()")}}</dt> + <dd>Cette méthode retourne une chaîne de caractères représentant le tableau et ses éléments en tenant compte de la locale. Elle redéfinit la méthode {{jsxref("Object.prototype.toLocaleString()")}}.</dd> +</dl> + +<h3 id="Méthodes_itératives">Méthodes itératives</h3> + +<p>Plusieurs méthodes utilisent des fonctions comme argument. Ces fonctions sont utilisées afin de traiter, d'une façon ou d'une autre, chaque élément du tableau. Lorsque ces méthodes sont invoquées, on évalue la longueur du tableau et on traite chacun des éléments dont l'indice est inférieur à la longueur (les éléments ajoutés en cours de route ne seront pas traités). Les autres modifications apportées au tableau (affecter une valeur ou supprimer un élément) peuvent avoir un impact sur les traitements des éléments suivants. Bien que ce comportement soit bien défini pour les différentes méthodes, afin de ne pas complexifier le code outre-mesure, lorsqu'on modifiera un tableau, on en créera une copie avant d'invoquer une telle méthode.</p> + +<dl> + <dt>{{jsxref("Array.prototype.entries()")}}</dt> + <dd>Cette méthode renvoie un nouvel objet <code>Array Iterator</code> qui contient les paires clef/valeur pour chaque index du tableau.</dd> + <dt>{{jsxref("Array.prototype.every()")}}</dt> + <dd>Cette méthode renvoie <code>true</code> si chaque élément du tableau satisfait la fonction de test passée en paramètre.</dd> + <dt>{{jsxref("Array.prototype.filter()")}}</dt> + <dd>Cette méthode crée un nouveau tableau contenant tous les éléments du tableau pour lesquels la fonction de filtrage passée en argument retourne <code>true</code>.</dd> + <dt>{{jsxref("Array.prototype.find()")}}</dt> + <dd>Cette méthode renvoie la valeur d'un élément trouvé dans le tableau et qui satisfait la fonction de test passée en paramètre, <code>undefined</code> sinon.</dd> + <dt>{{jsxref("Array.prototype.findIndex()")}}</dt> + <dd>Cette méthode renvoie l'index d'un élément trouvé dans le tableau qui satisfait la fonction de test passée en paramètre ou -1 si aucun ne la satisfait.</dd> + <dt>{{jsxref("Array.prototype.forEach()")}}</dt> + <dd>Cette méthode appelle une fonction sur chacun des éléments du tableau.</dd> + <dt>{{jsxref("Array.prototype.keys()")}}</dt> + <dd>Cette méthode retourne un nouvel <code>Array Iterator</code> qui contient les indices pour chaque élément dans le tableau.</dd> + <dt>{{jsxref("Array.prototype.map()")}}</dt> + <dd>Cette méthode crée un nouveau tableau contenant les images de chaque élément du tableau de départ par la fonction passée en paramètre.</dd> + <dt>{{jsxref("Array.prototype.reduce()")}}</dt> + <dd>Cette méthode applique une fonction sur un accumulateur et sur chaque valeur du tableau (de gauche à droite) de façon à obtenir une unique valeur à la fin.</dd> + <dt>{{jsxref("Array.prototype.reduceRight()")}}</dt> + <dd>Cette méthode applique une fonction sur un accumulateur et sur chaque valeur du tableau (de droite à gauche) de façon à obtenir une unique valeur à la fin.</dd> + <dt>{{jsxref("Array.prototype.some()")}}</dt> + <dd>Cette méthode renvoie <code>true</code> si au moins un élément du le tableau satisfait la fonction de test passée en paramètre.</dd> + <dt>{{jsxref("Array.prototype.values()")}}</dt> + <dd>Cette méthode renvoie un nouvel objet <code>Array Iterator</code> qui contient les valeurs de chaque indice du tableau.</dd> + <dt>{{jsxref("Array.prototype.@@iterator()", "Array.prototype[@@iterator]()")}} {{experimental_inline}}</dt> + <dd>Cette méthode renvoie un nouvel objet <code>Array Iterator</code> qui contient les valeurs de chaque indice du tableau.</dd> +</dl> + +<h3 id="Méthodes_génériques_(non-standard)">Méthodes génériques (non-standard)</h3> + +<p>De nombreuses méthodes des objets JavaScript de type <code>Array</code> sont conçues pour être appliquées de façon générale à tous les objets qui « ressemblent » à des tableaux. C'est à dire qu'elles peuvent être appliquées à n'importe quel objet qui possède une propriété <code>length</code>, et qui contint des propriétés indexées numériquement (comme lorsque l'on écrit <code>array[5]</code>). Certaines méthodes, comme {{jsxref("Array.join", "join")}}, se contentent de lire la propriété <code>length</code> et d'accéder à ces propriétés numériques de l'objet sur lesquelles on les appelle. D'autres, comme {{jsxref("Array.reverse", "reverse")}}, ont besoin de modifier les propriétés numériques et la longueur d'un objet ; ces méthodes ne peuvent dès lors pas être appelées sur des objets tels que des {{jsxref("String", "String")}}, qui ne permettent pas la modification de leur propriété <code>length</code> ni de leurs propriétés numériques.</p> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ES1')}}</td> + <td>{{Spec2('ES1')}}</td> + <td>Définition initiale.</td> + </tr> + <tr> + <td>{{SpecName('ES5.1', '#sec-15.4.3.1', 'Array.prototype')}}</td> + <td>{{Spec2('ES5.1')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('ES6', '#sec-array.prototype', 'Array.prototype')}}</td> + <td>{{Spec2('ES6')}}</td> + <td>Ajout des méthodes <code>copyWithin()</code>, <code>fill()</code>, <code>entries()</code>, <code>keys()</code>, <code>values()</code>, <code>find()</code>, <code>findIndex()</code>.</td> + </tr> + <tr> + <td>{{SpecName('ES7', '#sec-array.prototype', 'Array.prototype')}}</td> + <td>{{Spec2('ES7')}}</td> + <td>Ajout de la méthode <code>includes()</code>.</td> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-array.prototype', 'Array.prototype')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une<em>pull request</em>.</div> + +<p>{{Compat("javascript.builtins.Array.prototype")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{jsxref("Array", "Array")}}</li> + <li>{{jsxref("Function.prototype")}}</li> +</ul> diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/asyncfunction/prototype/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/asyncfunction/prototype/index.html new file mode 100644 index 0000000000..7343f73357 --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/asyncfunction/prototype/index.html @@ -0,0 +1,61 @@ +--- +title: AsyncFunction.prototype +slug: Web/JavaScript/Reference/Objets_globaux/AsyncFunction/prototype +tags: + - Experimental + - JavaScript + - Propriété + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype +--- +<div>{{JSRef}}</div> + +<p>La propriété <code><strong>AsyncFunction.prototype</strong></code> représente le prototype de l'objet {{jsxref("AsyncFunction")}}.</p> + +<h2 id="Description">Description</h2> + +<p>Les objets {{jsxref("AsyncFunction")}} héritent de <code>AsyncFunction.prototype</code>. <code>AsyncFunction.prototype</code> ne peut pas être modifiée.</p> + +<h2 id="Propriétés">Propriétés</h2> + +<dl> + <dt><code><strong>AsyncFunction.constructor</strong></code></dt> + <dd>La valeur initiale est {{jsxref("AsyncFunction")}}.</dd> + <dt><code><strong>AsyncFunction.prototype[@@toStringTag]</strong></code></dt> + <dd>Renvoie <code>"AsyncFunction"</code>.</dd> +</dl> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">État</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('ESDraft', '#sec-async-function-constructor-prototype', 'AsyncFunction.prototype')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td>Définition initiale dans ES2017.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div> +<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div> + +<p>{{Compat("javascript.builtins.AsyncFunction.prototype")}}</p> +</div> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{jsxref("AsyncFunction")}}</li> + <li>{{jsxref("Function")}}</li> +</ul> diff --git a/files/fr/orphaned/web/javascript/reference/global_objects/bigint/prototype/index.html b/files/fr/orphaned/web/javascript/reference/global_objects/bigint/prototype/index.html new file mode 100644 index 0000000000..e746754e5e --- /dev/null +++ b/files/fr/orphaned/web/javascript/reference/global_objects/bigint/prototype/index.html @@ -0,0 +1,63 @@ +--- +title: BigInt.prototype +slug: Web/JavaScript/Reference/Objets_globaux/BigInt/prototype +tags: + - BigInt + - JavaScript + - Propriété + - Prototype + - Reference +translation_of: Web/JavaScript/Reference/Global_Objects/BigInt/prototype +--- +<div>{{JSRef}}</div> + +<p>La propriété <strong><code>BigInt.prototype</code></strong> représente le prototype du constructeur {{jsxref("BigInt")}}.</p> + +<p>{{js_property_attributes(0, 0, 0)}}</p> + +<h2 id="Description">Description</h2> + +<p>L'ensemble des instances de {{jsxref("BigInt")}} héritent de <code>BigInt.prototype</code>. Le prototype du constructeur {{jsxref("BigInt")}} peut être modifié afin de modifier l'ensemble des instances de {{jsxref( "BigInt")}}.</p> + +<h2 id="Propriétés">Propriétés</h2> + +<dl> + <dt><code>BigInt.prototype.constructor</code></dt> + <dd>Cette propriété renvoie la fonction qui a crée cette instance. Par défaut, c'est l'objet {{jsxref("BigInt")}}.</dd> +</dl> + +<h2 id="Méthodes">Méthodes</h2> + +<dl> + <dt>{{jsxref("BigInt.prototype.toLocaleString()")}}</dt> + <dd>Cette méthode renvoie une chaîne de caractères représentant le nombre et adaptée à la locale choisie. Cette méthode surcharge la méthode {{jsxref("Object.prototype.toLocaleString()")}}.</dd> + <dt>{{jsxref("BigInt.prototype.toString()")}}</dt> + <dd>Cette méthode renvoie une chaîne de caractères représentant l'objet selon la base indiquée. Cette méthode surcharge la méthode {{jsxref("Object.prototype.toString()")}}.</dd> + <dt>{{jsxref("BigInt.prototype.valueOf()")}}</dt> + <dd>Cette méthode renvoie la valeur primitive de l'objet indiqué. Cette méthode surcharge la méthode {{jsxref("Object.prototype.valueOf()")}}.</dd> +</dl> + +<h2 id="Spécifications">Spécifications</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Spécification</th> + <th scope="col">Etat</th> + <th scope="col">Commentaires</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="https://tc39.github.io/proposal-bigint/#sec-bigint.prototype">BigInt.prototype</a></td> + <td>Brouillon de niveau 3</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("javascript.builtins.BigInt.prototype")}}</p> |