CKTIS / JavaScript
String.prototype.substring — extraire une partie d’une chaîne
substring() renvoie la partie d’une chaîne comprise entre start et end, sans inclure end. La chaîne d’origine reste inchangée ; les indices sont limités à sa longueur et les bornes sont inversées si elles sont dans le mauvais ordre.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
str.substring(start, end)String.prototype.substring renvoie une chaîne primitive sans modifier l’originale. Les indices commencent à zéro : start est inclus et end est exclu. Si end est omis ou si undefined est passé, la fin de la chaîne est utilisée ; si start est omis, zéro est utilisé.
Les arguments sont convertis en nombres, et leurs parties fractionnaires sont tronquées vers zéro. NaN et les valeurs négatives deviennent zéro ; les valeurs supérieures à la longueur de la chaîne sont ramenées à cette longueur. La méthode inverse ensuite les bornes si start est supérieur à end. Des bornes égales produisent "".
Contrairement à slice(), les indices négatifs ne comptent pas à rebours depuis la fin, et des bornes inversées n’imposent pas un résultat vide. Les indices désignent des unités de code UTF-16, et non des caractères visibles complets ; couper une paire de substitution peut renvoyer un caractère incomplet.
Il s’agit d’une méthode de la bibliothèque standard ECMAScript, et non d’une API Web. L’exemple illustre une plage, des bornes inversées, un indice négatif, l’omission de end et un résultat vide.
Exemples
const text = "JavaScript";
console.log(text.substring(4, 10));
console.log(text.substring(10, 4));
console.log(text.substring(-3, 4));
console.log(text.substring(4));
console.log(JSON.stringify(text.substring(4, 4)));Résultat
Script Script Java Script ""
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.