convert content to md

1 files changed, 71 insertions, 91 deletions

diff --git a/files/fr/web/javascript/reference/global_objects/array/indexof/index.md b/files/fr/web/javascript/reference/global_objects/array/indexof/index.md
index cdd545abc9..14d8d2e1f4 100644
--- a/files/fr/web/javascript/reference/global_objects/array/indexof/index.md
+++ b/files/fr/web/javascript/reference/global_objects/array/indexof/index.md
@@ -11,57 +11,55 @@ tags:
 translation_of: Web/JavaScript/Reference/Global_Objects/Array/indexOf
 original_slug: Web/JavaScript/Reference/Objets_globaux/Array/indexOf
 ---
-<div>{{JSRef}}</div>
+{{JSRef}}
 
-<p>La méthode <code><strong>indexOf()</strong></code> renvoie le premier indice pour lequel on trouve un élément donné dans un tableau. Si l'élément cherché n'est pas présent dans le tableau, la méthode renverra -1.</p>
+La méthode **`indexOf()`** renvoie le premier indice pour lequel on trouve un élément donné dans un tableau. Si l'élément cherché n'est pas présent dans le tableau, la méthode renverra -1.
 
-<div class="note">
-<p><strong>Note :</strong> pour la méthode associée aux chaînes de caractères, voir la page {{jsxref("String.prototype.indexOf()")}}.</p>
-</div>
+> **Note :** pour la méthode associée aux chaînes de caractères, voir la page {{jsxref("String.prototype.indexOf()")}}.
 
-<div>{{EmbedInteractiveExample("pages/js/array-indexof.html")}}</div>
+{{EmbedInteractiveExample("pages/js/array-indexof.html")}}
 
-<h2 id="Syntaxe">Syntaxe</h2>
+## Syntaxe
 
-<pre class="syntaxbox"><var>arr</var>.indexOf(<var>élémentRecherché</var>)
-<var>arr</var>.indexOf(<var>élémentRecherché</var>, indiceDébut)
-</pre>
+    arr.indexOf(élémentRecherché)
+    arr.indexOf(élémentRecherché, indiceDébut)
 
-<h3 id="Paramètres">Paramètres</h3>
+### Paramètres
 
-<dl>
- <dt><code>élémentRecherché</code></dt>
- <dd>L'élément qu'on cherche dans le tableau</dd>
- <dt><code>indiceDébut</code> {{optional_inline}}</dt>
- <dd>L'index à partir duquel commencer la recherche. La valeur par défaut est 0 (le tableau sera parcouru dans sa totalité). Si l'index est plus grand ou égal à la longueur du tableau, la méthode renverra -1. Si l'index est négatif, la recherche commencera d'autant d'éléments, à partir de la fin du tableau. À noter que même si l'index est négatif, la recherche s'effectue toujours du début jusqu'à la fin du tableau. Si l'index fourni est inférieur à 0, le tableau sera entièrement parcouru.</dd>
-</dl>
+- `élémentRecherché`
+  - : L'élément qu'on cherche dans le tableau
+- `indiceDébut` {{optional_inline}}
+  - : L'index à partir duquel commencer la recherche. La valeur par défaut est 0 (le tableau sera parcouru dans sa totalité). Si l'index est plus grand ou égal à la longueur du tableau, la méthode renverra -1. Si l'index est négatif, la recherche commencera d'autant d'éléments, à partir de la fin du tableau. À noter que même si l'index est négatif, la recherche s'effectue toujours du début jusqu'à la fin du tableau. Si l'index fourni est inférieur à 0, le tableau sera entièrement parcouru.
 
-<h3 id="Valeur_de_retour">Valeur de retour</h3>
+### Valeur de retour
 
-<p>Le premier index de l'élément dans le tableau ou -1 si la valeur n'est pas trouvée.</p>
+Le premier index de l'élément dans le tableau ou -1 si la valeur n'est pas trouvée.
 
-<h2 id="Description">Description</h2>
+## Description
 
-<p><code>indexOf</code> compare <code>élémentRecherché</code> aux éléments contenus dans le tableau en utilisant une <a href="/fr/docs/Web/JavaScript/Reference/Opérateurs/Opérateurs_de_comparaison#.C3.89galit.C3.A9_stricte_(.3D.3D.3D)">égalité stricte</a> (la même méthode utilisée par l'opérateur <code>===</code>).</p>
+`indexOf` compare `élémentRecherché` aux éléments contenus dans le tableau en utilisant une [égalité stricte](</fr/docs/Web/JavaScript/Reference/Opérateurs/Opérateurs_de_comparaison#.C3.89galit.C3.A9_stricte_(.3D.3D.3D)>) (la même méthode utilisée par l'opérateur `===`).
 
-<h2 id="Exemples">Exemples</h2>
+## Exemples
 
-<h3 id="Utiliser_indexOf()">Utiliser <code>indexOf()</code></h3>
+### Utiliser `indexOf()`
 
-<p>Dans l'exemple qui suit, on peut utiliser <code>indexOf</code> afin de trouver l'emplacement d'un élément dans un tableau.</p>
+Dans l'exemple qui suit, on peut utiliser `indexOf` afin de trouver l'emplacement d'un élément dans un tableau.
 
-<pre class="brush: js">var tableau = [2, 9, 9];
+```js
+var tableau = [2, 9, 9];
 tableau.indexOf(2);     // 0
 tableau.indexOf(7);     // -1
 tableau.indexOf(9, 2);  // 2
 tableau.indexOf(2, -1); // -1
-tableau.indexOf(2, -3); // 0</pre>
+tableau.indexOf(2, -3); // 0
+```
 
-<h3 id="Trouver_toutes_les_occurences_d'un_élément">Trouver toutes les occurences d'un élément</h3>
+### Trouver toutes les occurences d'un élément
 
-<p>Dans l'exemple qui suit, on utilise <code>indexOf()</code> afin de trouver tous les indices d'un élément dans un tableau. On peut utiliser la méthode {{jsxref("Array.prototype.push", "push")}} afin d'ajouter ces indices dans un autre tableau.</p>
+Dans l'exemple qui suit, on utilise `indexOf()` afin de trouver tous les indices d'un élément dans un tableau. On peut utiliser la méthode {{jsxref("Array.prototype.push", "push")}} afin d'ajouter ces indices dans un autre tableau.
 
-<pre class="brush: js">var indices = [];
+```js
+var indices = [];
 var tableau = ['a', 'b', 'a', 'c', 'a', 'd'];
 var élément = 'a';
 var idx = tableau.indexOf(élément);
@@ -70,15 +68,17 @@ while (idx != -1) {
   idx = tableau.indexOf(élément, idx + 1);
 }
 console.log(indices);
-// [0, 2, 4]</pre>
+// [0, 2, 4]
+```
 
-<h3 id="Trouver_si_un_élément_existe_et_l'ajouter_dans_le_tableau_si_ce_n'est_pas_le_cas">Trouver si un élément existe et l'ajouter dans le tableau si ce n'est pas le cas</h3>
+### Trouver si un élément existe et l'ajouter dans le tableau si ce n'est pas le cas
 
-<pre class="brush: js">function mettreAJourLegumes(tabLégumes, légume) {
+```js
+function mettreAJourLegumes(tabLégumes, légume) {
     if (tabLégumes.indexOf(légume) === -1) {
         tabLégumes.push(légume);
         console.log('Le nouveau tableau est : ' + tabLégumes);
-    } else if (tabLégumes.indexOf(légume) &gt; -1) {
+    } else if (tabLégumes.indexOf(légume) > -1) {
         console.log(légume + ' existe déjà dans le tableau.');
     }
 }
@@ -88,13 +88,15 @@ var tabLégumes = ['pomme de terre', 'tomate', 'poivron'];
 mettreAJourLegumes(tabLégumes, 'épinard');
 // Le nouveau tableau est : pomme de terre,tomate,poivron,épinard
 mettreAJourLegumes(tabLégumes, 'épinard');
-// épinard existe déjà dans le tableau.</pre>
+// épinard existe déjà dans le tableau.
+```
 
-<h2 id="Prothèse_d'émulation_(polyfill)">Prothèse d'émulation (<em>polyfill</em>)</h2>
+## Prothèse d'émulation (_polyfill_)
 
-<p><code>indexOf</code> fut ajouté avec la cinquième édition du standard ECMA-262 ; il peut donc ne pas être présent dans tous les navigateurs web. Vous pouvez contourner ce problème en insérant le code suivant au début de vos scripts. Il permet d'utiliser <code>indexOf</code> dans les environnements qui ne le supportent pas nativement. L'algorithme est le même que celui spécifié dans ECMAScript 5 si on a bien {{jsxref("TypeError", "TypeError")}} et {{jsxref("Math.abs")}} qui ont leurs valeurs originales :</p>
+`indexOf` fut ajouté avec la cinquième édition du standard ECMA-262 ; il peut donc ne pas être présent dans tous les navigateurs web. Vous pouvez contourner ce problème en insérant le code suivant au début de vos scripts. Il permet d'utiliser `indexOf` dans les environnements qui ne le supportent pas nativement. L'algorithme est le même que celui spécifié dans ECMAScript 5 si on a bien {{jsxref("TypeError", "TypeError")}} et {{jsxref("Math.abs")}} qui ont leurs valeurs originales :
 
-<pre class="brush: js">// Production steps of ECMA-262, Edition 5, 15.4.4.14
+```js
+// Production steps of ECMA-262, Edition 5, 15.4.4.14
 // Référence : http://es5.github.io/#x15.4.4.14
 if (!Array.prototype.indexOf) {
   Array.prototype.indexOf = function(searchElement, fromIndex) {
@@ -113,7 +115,7 @@ if (!Array.prototype.indexOf) {
     //    méthode interne Get de O avec l'argument
     //    "length".
     // 3. Soit len le résultat de ToUint32(lenValue).
-    var len = O.length &gt;&gt;&gt; 0;
+    var len = O.length >>> 0;
 
     // 4. Si len vaut 0, on renvoie -1.
     if (len === 0) {
@@ -129,18 +131,18 @@ if (!Array.prototype.indexOf) {
       n = 0;
     }
 
-    // 6. Si n &gt;= len, on renvoie -1.
-    if (n &gt;= len) {
+    // 6. Si n >= len, on renvoie -1.
+    if (n >= len) {
       return -1;
     }
 
-    // 7. Si n &gt;= 0, soit k égal à n.
-    // 8. Sinon, si n&lt;0, soit k égal à len - abs(n).
+    // 7. Si n >= 0, soit k égal à n.
+    // 8. Sinon, si n<0, soit k égal à len - abs(n).
     //    Si k est inférieur à 0, on ramène k égal à 0.
-    k = Math.max(n &gt;= 0 ? n : len - Math.abs(n), 0);
+    k = Math.max(n >= 0 ? n : len - Math.abs(n), 0);
 
-    // 9. On répète tant que k &lt; len
-    while (k &lt; len) {
+    // 9. On répète tant que k < len
+    while (k < len) {
       // a. Soit Pk égal à ToString(k).
       //    Ceci est implicite pour l'opérande gauche de in
       // b. Soit kPresent le résultat de l'appel de la
@@ -155,55 +157,33 @@ if (!Array.prototype.indexOf) {
       //        l'algorithme d'égalité stricte entre
       //        searchElement et elementK.
       //  iii.  Si same vaut true, on renvoie k.
-      if (k in O &amp;&amp; O[k] === searchElement) {
+      if (k in O && O[k] === searchElement) {
         return k;
       }
       k++;
     }
     return -1;
   };
-}</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('ES5.1', '#sec-15.4.4.14', 'Array.prototype.indexOf')}}</td>
-   <td>{{Spec2('ES5.1')}}</td>
-   <td>Définition initiale. Implémentée avec JavaScript 1.6.</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('ES6', '#sec-array.prototype.indexof', 'Array.prototype.indexOf')}}</td>
-   <td>{{Spec2('ES6')}}</td>
-   <td> </td>
-  </tr>
-  <tr>
-   <td>{{SpecName('ESDraft', '#sec-array.prototype.indexof', 'Array.prototype.indexOf')}}</td>
-   <td>{{Spec2('ESDraft')}}</td>
-   <td> </td>
-  </tr>
- </tbody>
-</table>
-
-<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
-
-<p>{{Compat("javascript.builtins.Array.indexOf")}}</p>
-
-<h2 id="Notes_de_compatibilité">Notes de compatibilité</h2>
-
-<ul>
- <li>À partir de Firefox 47 ({{geckoRelease(47)}}), cette méthode ne renverra plus <code>-0</code>. Ainsi, <code>[0].indexOf(0, -0)</code> renverra toujours <code>+0</code> (cf. {{bug(1242043)}}).</li>
-</ul>
-
-<h2 id="Voir_aussi">Voir aussi</h2>
-
-<ul>
- <li>{{jsxref("Array.prototype.lastIndexOf()")}}</li>
- <li>{{jsxref("TypedArray.prototype.indexOf()")}}</li>
-</ul>
+}
+```
+
+## Spécifications
+
+| Spécification                                                                                                | État                         | Commentaires                                          |
+| ------------------------------------------------------------------------------------------------------------ | ---------------------------- | ----------------------------------------------------- |
+| {{SpecName('ES5.1', '#sec-15.4.4.14', 'Array.prototype.indexOf')}}                     | {{Spec2('ES5.1')}}     | Définition initiale. Implémentée avec JavaScript 1.6. |
+| {{SpecName('ES6', '#sec-array.prototype.indexof', 'Array.prototype.indexOf')}}     | {{Spec2('ES6')}}         |                                                       |
+| {{SpecName('ESDraft', '#sec-array.prototype.indexof', 'Array.prototype.indexOf')}} | {{Spec2('ESDraft')}} |                                                       |
+
+## Compatibilité des navigateurs
+
+{{Compat("javascript.builtins.Array.indexOf")}}
+
+## Notes de compatibilité
+
+- À partir de Firefox 47 ({{geckoRelease(47)}}), cette méthode ne renverra plus `-0`. Ainsi, `[0].indexOf(0, -0)` renverra toujours `+0` (cf. {{bug(1242043)}}).
+
+## Voir aussi
+
+- {{jsxref("Array.prototype.lastIndexOf()")}}
+- {{jsxref("TypedArray.prototype.indexOf()")}}