diff options
Diffstat (limited to 'files/fr/conflicting/web/javascript/reference/global_objects/string/index.html')
| -rw-r--r-- | files/fr/conflicting/web/javascript/reference/global_objects/string/index.html | 190 |
1 files changed, 190 insertions, 0 deletions
diff --git a/files/fr/conflicting/web/javascript/reference/global_objects/string/index.html b/files/fr/conflicting/web/javascript/reference/global_objects/string/index.html new file mode 100644 index 0000000000..f7fc1c80a6 --- /dev/null +++ b/files/fr/conflicting/web/javascript/reference/global_objects/string/index.html @@ -0,0 +1,190 @@ +--- +title: String.prototype +slug: Web/JavaScript/Reference/Objets_globaux/String/prototype +tags: + - JavaScript + - Propriété + - Prototype + - Reference + - String +translation_of: Web/JavaScript/Reference/Global_Objects/String +translation_of_original: Web/JavaScript/Reference/Global_Objects/String/prototype +--- +<div>{{JSRef}}</div> + +<p>La propriété <strong><code>String.prototype</code></strong> représente l'objet prototype de {{jsxref("String")}}.</p> + +<div>{{js_property_attributes(0,0,0)}}</div> + +<h2 id="Description">Description</h2> + +<p>Toutes les instances de {{jsxref("String")}} héritent de <code>String.prototype</code>. Les modifications de l'objet prototype <code>String</code> sont répercutées sur toutes les instances de <code>String</code>.</p> + +<h2 id="Propriétés">Propriétés</h2> + +<dl> + <dt><code>String.prototype.constructor</code></dt> + <dd>Définit la fonction créant le prototype d'un objet.</dd> + <dt>{{jsxref("String.prototype.length")}}</dt> + <dd>Reflète la longueur de la chaîne</dd> + <dt><code><em>N</em></code></dt> + <dd>Utilisée pour accéder au caractère en <em>N</em><sup>ème</sup> position où <em>N</em> est un entier entre 0 et la valeur de {{jsxref("String.length")}} moins un. Ces propriétés sont en lecture seule.</dd> +</dl> + +<h2 id="Méthodes">Méthodes</h2> + +<h3 id="Méthodes_non_liées_à_HTML">Méthodes non liées à HTML</h3> + +<dl> + <dt>{{jsxref("String.prototype.charAt()")}}</dt> + <dd>Renvoie le caractère (ou plus précisement, le point de code UTF-16) à la position spécifiée.</dd> + <dt>{{jsxref("String.prototype.charCodeAt()")}}</dt> + <dd>Renvoie un nombre indiquant la valeur du point de code UTF-16 du caractère à la position spécifiée.</dd> + <dt>{{jsxref("String.prototype.codePointAt()")}}</dt> + <dd>Renvoie un entier positif qui est la valeur du codet UTF-16 à la position donnée.</dd> + <dt>{{jsxref("String.prototype.concat()")}}</dt> + <dd>Combine le texte de deux chaînes et renvoie une nouvelle chaîne.</dd> + <dt>{{jsxref("String.prototype.includes()")}}</dt> + <dd>Défini si une chaîne de caractères est contenue dans une autre chaîne de caractères.</dd> + <dt>{{jsxref("String.prototype.endsWith()")}}</dt> + <dd>Défini si une chaîne de caractère se termine par une chaîne de caractères spécifique.</dd> + <dt>{{jsxref("String.prototype.indexOf()")}}</dt> + <dd>Renvoie la position, au sein de l'objet <code>String</code> appelant, de la première occurrence de la valeur spécifiée, ou -1 si celle-ci n'est pas trouvée.</dd> + <dt>{{jsxref("String.prototype.lastIndexOf()")}}</dt> + <dd>Renvoie la position, au sein de l'objet String appelant, de la dernière occurrence de la valeur spécifiée, ou -1 si celle-ci n'est pas trouvée.</dd> + <dt>{{jsxref("String.prototype.localeCompare()")}}</dt> + <dd>Renvoie un nombre indiquant si une chaîne de référence vient avant, après ou est en position identique à la chaîne donnée selon un ordre de tri.</dd> + <dt>{{jsxref("String.prototype.match()")}}</dt> + <dd>Utilisée pour faire correspondre une expression rationnelle avec une chaîne.</dd> + <dt>{{jsxref("String.prototype.matchAll()")}}</dt> + <dd>Renvoie un itérateur listant l'ensemble des correspondances d'une expression rationnelle avec la chaîne.</dd> + <dt>{{jsxref("String.prototype.normalize()")}}</dt> + <dd>Retourne la forme Unicode normalisée de la chaîne de caractères appelée.</dd> + <dt>{{jsxref("String.prototype.padEnd()")}}</dt> + <dd>Complète la chaîne courante avec une autre chaîne de caractères, éventuellement répétée, afin d'obtenir une nouvelle chaîne de la longueur indiquée. La chaîne complémentaire est ajoutée à la fin.</dd> + <dt>{{jsxref("String.prototype.padStart()")}}</dt> + <dd>Complète la chaîne courante avec une autre chaîne de caractères, éventuellement répétée, afin d'obtenir une nouvelle chaîne de la longueur indiquée. La chaîne complémentaire est ajoutée au début.</dd> +</dl> + +<dl> + <dt>{{jsxref("String.prototype.quote()")}} {{obsolete_inline}}</dt> + <dd>Entoure la chaîne de guillemets doubles anglais ("<code>"</code>").</dd> + <dt>{{jsxref("String.prototype.repeat()")}}</dt> + <dd>Renvoie une chaîne dont le contenu est la chaîne courante répétée un certain nombre de fois.</dd> + <dt>{{jsxref("String.prototype.replace()")}}</dt> + <dd>Utilisée pour rechercher une correspondance entre une expression rationnelle et une chaîne, et pour remplacer la sous-chaîne correspondante par une nouvelle chaîne.</dd> + <dt>{{jsxref("String.prototype.search()")}}</dt> + <dd>Exécute la recherche d'une correspondance entre une expression régulière et une chaîne spécifiée.</dd> + <dt>{{jsxref("String.prototype.slice()")}}</dt> + <dd>Extrait une section d'une chaîne et renvoie une nouvelle chaîne.</dd> + <dt>{{jsxref("String.prototype.split()")}}</dt> + <dd>Sépare un objet String en un tableau de chaînes en séparant la chaîne en plusieurs sous-chaînes.</dd> + <dt>{{jsxref("String.prototype.startsWith()")}}</dt> + <dd>Détermine si une chaîne commence avec les caractères d'une autre chaîne.</dd> + <dt>{{jsxref("String.prototype.substr()")}} {{deprecated_inline}}</dt> + <dd>Renvoie les caractères d'une chaîne à partir de la position spécifiée et pour la longueur spécifiée.</dd> + <dt>{{jsxref("String.prototype.substring()")}}</dt> + <dd>Renvoie les caractères d'une chaîne entre deux positions dans celle-ci.</dd> + <dt>{{jsxref("String.prototype.toLocaleLowerCase()")}}</dt> + <dd>Les caractères de la chaîne seront convertis en minuscules selon la locale courante. Pour la plupart des langues, le résultat est identique à {{jsxref("String.prototype.toLowerCase()", "toLowerCase()")}}.</dd> + <dt>{{jsxref("String.prototype.toLocaleUpperCase()")}}</dt> + <dd>Les caractères de la chaîne seront convertis en majuscules selon la locale courante. Pour la plupart des langues, le résultat est identique à {{jsxref("String.toUpperCase()", "toUpperCase()")}}.</dd> + <dt>{{jsxref("String.prototype.toLowerCase()")}}</dt> + <dd>Renvoie la valeur de la chaîne appelante convertie en minuscules.</dd> + <dt>{{jsxref("String.prototype.toSource()")}} {{ Non-standard_inline() }}</dt> + <dd>Renvoie une représentation littérale de l'objet; celle-ci peut être utilisée pour créer un nouvel objet. Remplace la méthode {{jsxref("Object.prototype.toSource()")}}.</dd> + <dt>{{jsxref("String.prototype.toString()")}}</dt> + <dd>Renvoie une chaîne représentant l'objet spécifié. Remplace la méthode {{jsxref("Object.prototype.toString()")}}.</dd> + <dt>{{jsxref("String.prototype.toUpperCase()")}}</dt> + <dd>Renvoie la valeur de la chaîne appelante convertie en majuscules.</dd> + <dt>{{jsxref("String.prototype.trim()")}}</dt> + <dd>Retire les blancs en début et en fin de chaîne. Cette méthode a été définie avec ECMAScript 5.</dd> + <dt>{{jsxref("String.prototype.trimStart()")}}<br> + {{jsxref("String.prototype.trimLeft()")}}</dt> + <dd>Retire les blancs situés au début de la chaîne.</dd> + <dt>{{jsxref("String.prototype.trimEnd()")}}<br> + {{jsxref("String.prototype.trimRight()")}}</dt> + <dd>Retire les blancs situés à la fin de la chaîne.</dd> + <dt>{{jsxref("String.prototype.valueOf()")}}</dt> + <dd>Renvoie la valeur primitive de l'objet spécifié. Remplace la méthode {{jsxref("Object.prototype.valueOf()")}}.</dd> + <dt>{{jsxref("String.prototype.@@iterator()","String.prototype[@@iterator]()")}}</dt> + <dd>Renvoie un nouvel objet <code>Iterator</code> qui permet d'itérer sur les codets de la chaîne, chaque codet étant renvoyé comme une chaîne.</dd> +</dl> + +<h3 id="Méthodes_de_transformation_HTML">Méthodes de transformation HTML</h3> + +<p>Ces méthodes ont une utilisation limitée, étant donné qu'elles ne fournissent qu'un petit sous-ensemble des balises et attributs HTML existants.</p> + +<dl> + <dt>{{jsxref("String.prototype.anchor()")}} {{deprecated_inline}}</dt> + <dd>{{htmlattrxref("name", "a", "<a name=\"name\">")}} (cible hypertexte)</dd> + <dt>{{jsxref("String.prototype.big()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("big")}}</dd> + <dt>{{jsxref("String.prototype.blink()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("blink")}}</dd> + <dt>{{jsxref("String.prototype.bold()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("b")}}</dd> + <dt>{{jsxref("String.prototype.fixed()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("tt")}}</dd> + <dt>{{jsxref("String.prototype.fontcolor()")}} {{deprecated_inline}}</dt> + <dd>{{htmlattrxref("color", "font", "<font color=\"color\">")}}</dd> + <dt>{{jsxref("String.prototype.fontsize()")}} {{deprecated_inline}}</dt> + <dd>{{htmlattrxref("size", "font", "<font size=\"size\">")}}</dd> + <dt>{{jsxref("String.prototype.italics()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("i")}}</dd> + <dt>{{jsxref("String.prototype.link()")}} {{deprecated_inline}}</dt> + <dd>{{htmlattrxref("href", "a", "<a href=\"url\">")}} (lien vers une URL)</dd> + <dt>{{jsxref("String.prototype.small()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("small")}}</dd> + <dt>{{jsxref("String.prototype.strike()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("strike")}}</dd> + <dt>{{jsxref("String.prototype.sub()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("sub")}}</dd> + <dt>{{jsxref("String.prototype.sup()")}} {{deprecated_inline}}</dt> + <dd>{{HTMLElement("sup")}}</dd> +</dl> + +<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('ES1')}}</td> + <td>{{Spec2('ES1')}}</td> + <td>Définition initiale.</td> + </tr> + <tr> + <td>{{SpecName('ES5.1', '#sec-15.5.3.1', 'String.prototype')}}</td> + <td>{{Spec2('ES5.1')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('ES6', '#sec-string.prototype', 'String.prototype')}}</td> + <td>{{Spec2('ES6')}}</td> + <td> </td> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-string.prototype', 'String.prototype')}}</td> + <td>{{Spec2('ESDraft')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<p 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 à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</p> + +<p>{{Compat("javascript.builtins.String.prototype")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{jsxref("String")}}</li> + <li>{{jsxref("Function.prototype")}}</li> +</ul> |