String.prototype.substring()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
String 的 substring() 方法返回该字符串从起始索引到结束索引（不包括）的部分，如果未提供结束索引，则返回到字符串末尾的部分。
尝试一下
const str = "Mozilla";
console.log(str.substring(1, 3));
// Expected output: "oz"
console.log(str.substring(2));
// Expected output: "zilla"
语法
substring(indexStart)
substring(indexStart, indexEnd)
参数
indexStart-
返回子字符串中第一个要包含的字符的索引。
indexEnd可选-
返回子字符串中第一个要排除的字符的索引。
返回值
包含给定字符串的指定部分的新字符串。
描述
substring() 方法从 indexStart 开始提取字符，直到（但不包括）indexEnd。具体来说：
- 如果省略了
indexEnd，则substring()提取字符直到字符串的末尾。 - 如果
indexStart等于indexEnd，则substring()返回一个空字符串。 - 如果
indexStart大于indexEnd，则substring()的效果就像交换了这两个参数一样；请参考下面的示例。
任何小于 0 或大于 str.length 的参数值都会被视为分别等于 0 和 str.length。
任何值为 NaN 的参数将被视为等于 0。
示例
使用 substring()
下例使用 substring 输出字符串 "Mozilla" 中的字符：
const anyString = "Mozilla";
console.log(anyString.substring(0, 1)); // 'M'
console.log(anyString.substring(1, 0)); // 'M'
console.log(anyString.substring(0, 6)); // 'Mozill'
console.log(anyString.substring(4)); // 'lla'
console.log(anyString.substring(4, 7)); // 'lla'
console.log(anyString.substring(7, 4)); // 'lla'
console.log(anyString.substring(0, 7)); // 'Mozilla'
console.log(anyString.substring(0, 10)); // 'Mozilla'
调用 substring() 时使用 length 属性
以下示例使用 substring() 方法和 length 属性来提取特定字符串的最后字符。这种方法可能更容易记住，因为你不需要像上面的示例那样知道起始和结束索引。
const text = "Mozilla";
// 获取字符串的最后 4 个字符
console.log(text.substring(text.length - 4)); // 打印“illa”
// 获取字符串的最后 5 个字符
console.log(text.substring(text.length - 5)); // 打印“zilla”
substring() 和 substr() 之间的区别
substring() 和 substr() 方法之间存在细微差别，因此你应该小心不要混淆它们。
substr()方法的两个参数是start和length，而substring()方法的参数是start和end。- 如果
substr()的start索引为负数，它将循环到字符串的末尾，而substring()会将其限制为0。 - 在
substr()中，如果长度为负数，将被视为零；而在substring()中，如果end小于start，则会交换这两个索引。
此外，substr() 被认为是 ECMAScript 中的遗留特性，因此如果可能的话最好避免使用它。
const text = "Mozilla";
console.log(text.substring(2, 5)); // "zil"
console.log(text.substr(2, 3)); // "zil"
substring() 和 slice() 之间的区别
substring() 和 slice() 方法几乎相同，但在处理负数参数时有一些细微差别。
substring() 方法在 indexStart 大于 indexEnd 的情况下会交换它的两个参数，这意味着仍会返回一个字符串。而 slice() 方法在这种情况下返回一个空字符串。
const text = "Mozilla";
console.log(text.substring(5, 2)); // "zil"
console.log(text.slice(5, 2)); // ""
如果两个参数中的任何一个或两个都是负数或 NaN，substring() 方法将把它们视为 0。
console.log(text.substring(-5, 2)); // "Mo"
console.log(text.substring(-5, -2)); // ""
slice() 方法也将 NaN 参数视为 0，但当给定负值时，它会从字符串的末尾开始反向计数以找到索引。
console.log(text.slice(-5, 2)); // ""
console.log(text.slice(-5, -2)); // "zil"
请参阅 slice() 页面以获取更多关于负数的示例。
替换字符串中的子字符串
以下示例替换字符串中的子字符串。它可以替换单个字符和子字符串。示例的最后一个函数调用将字符串 Brave New World 更改为 Brave New Web。
// 将字符串 fullS 中的 oldS 替换为 newS
function replaceString(oldS, newS, fullS) {
for (let i = 0; i < fullS.length; ++i) {
if (fullS.substring(i, i + oldS.length) === oldS) {
fullS =
fullS.substring(0, i) +
newS +
fullS.substring(i + oldS.length, fullS.length);
}
}
return fullS;
}
replaceString("World", "Web", "Brave New World");
请注意，如果 oldS 本身是 newS 的子字符串，这可能导致无限循环，例如，假如你尝试在此处用 "OtherWorld" 替换 "World"。
替换字符串的更好方法如下：
function replaceString(oldS, newS, fullS) {
return fullS.split(oldS).join(newS);
}
上面的代码仅作为子字符串操作的示例。如果你需要替换子字符串，大多数情况下你会想要使用 String.prototype.replace() 函数。
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.substring |
浏览器兼容性
Loading…