输入边界断言：^、$

语法

^
$

描述

^ 断言当前位置是输入的开头，$ 断言当前位置是输入的结尾。因为两者都是断言，它们不会消耗任何字符。

更准确地说，^ 断言左侧的字符超出了字符串的范围；$ 断言右侧的字符超出了字符串的范围。如果设置了 m 标志，则 ^ 也会匹配左侧字符是行终止符的情况，$ 同理也会匹配右侧字符是行结束符的情况。

除非设置了 m 标志，否则 ^ 和 $ 断言仅在位于模式边界时才有意义，因为它们左侧或右侧的任何其他字符都会导致断言失败。

y 标志不会改变这些断言的含义——参见锚定粘性标志。

示例

移除末尾的斜杠

以下示例用于从 URL 字符串中移除尾随斜杠：

function removeTrailingSlash(url) {
  return url.replace(/\/$/, "");
}

removeTrailingSlash("https://example.com/"); // "https://example.com"
removeTrailingSlash("https://example.com/docs/"); // "https://example.com/docs"

匹配文件扩展名

以下示例通过匹配文件扩展名来检查文件类型，文件扩展名总是位于字符串的末尾：

function isImage(filename) {
  return /\.(?:png|jpe?g|webp|avif|gif)$/i.test(filename);
}

isImage("image.png"); // true
isImage("image.jpg"); // true
isImage("image.pdf"); // false

匹配整个输入

有时，需要确保正则表达式匹配整个输入内容，而不仅仅是输入的子字符串。例如，如果需要判断一个字符串是否为有效的标识符，可以在模式的两端添加输入边界断言：

function isValidIdentifier(str) {
  return /^[$_\p{ID_Start}][$_\p{ID_Continue}]*$/u.test(str);
}

isValidIdentifier("foo"); // true
isValidIdentifier("$1"); // true
isValidIdentifier("1foo"); // false
isValidIdentifier("  foo  "); // false

该函数在进行代码生成（即使用代码生成代码）时非常有用，因为你可使用与其他字符串属性不同的合法标识符，如使用点号表示法代替方括号表示法：

const variables = ["foo", "foo:bar", "  foo  "];

function toAssignment(key) {
  if (isValidIdentifier(key)) {
    return `globalThis.${key} = undefined;`;
  }
  // JSON.stringify() 转义引号和其他特殊字符
  return `globalThis[${JSON.stringify(key)}] = undefined;`;
}

const statements = variables.map(toAssignment).join("\n");

console.log(statements);
// globalThis.foo = undefined;
// globalThis["foo:bar"] = undefined;
// globalThis["  foo  "] = undefined;

规范

浏览器兼容性

参见

• 断言指南
• 正则表达式
• 单词边界断言：\b、\B
• 前向断言：(?=...)、(?!...)
• 后向断言：(?<=...)、(?<!...)