大网数据广告活动
Web 标准与前端开发

String.prototype.search()

· 52CE 我爱测

**`search()`** 方法用于在 String 对象中执行正则表达式的搜索,寻找匹配项。

search() 方法用于在 String 对象中执行正则表达式的搜索,寻找匹配项。

JavaScript Demo: String.search()

const paragraph = "I think Ruth's dog is cuter than your dog!";

// Anything not a word character, whitespace or apostrophe
const regex = /[^\w\s']/g;

console.log(paragraph.search(regex));
// Expected output: 41

console.log(paragraph[paragraph.search(regex)]);
// Expected output: "!"

语法

search(regexp)

参数

  • regexp
    • : 一个正则表达式对象,或者具有 Symbol.search 方法的任意对象。

      如果 regexp 不是 RegExp 对象,并且不具有 Symbol.search 方法,则会使用 new RegExp(regexp) 将其隐式转换为 RegExp。

返回值

如果匹配成功,则返回正则表达式在字符串中首次匹配的索引;否则,返回 -1。

描述

String.prototype.search() 方法的实现非常简单——它只是将该字符串作为调用实参拥有的 Symbol.search 方法的第一个参数。实际的实现来自于 RegExp.prototype[Symbol.search]()。

regexp 的 g 标志对 search() 方法的结果没有影响,搜索总是以正则表达式的 lastIndex 为 0 进行。有关 search() 方法行为的更多信息,请参阅 RegExp.prototype[Symbol.search]()。

当你想知道字符串中是否存在某个模式,并且还想知道它在字符串中的索引时,可以使用 search() 方法。

  • 如果你只想知道某个模式是否存在,请使用 RegExp.prototype.test() 方法,它返回一个布尔值。
  • 如果你需要获取匹配文本的内容,请使用 String.prototype.match() 或 RegExp.prototype.exec()。

示例

使用 search()

下面的示例中用两个不同的正则表达式对同一个字符串执行搜索匹配,得到一个成功匹配(正数返回值)和一个失败匹配(-1)。

const str = "hey JudE";
const re = /[A-Z]/;
const reDot = /[.]/;
console.log(str.search(re)); // 返回 4,这是第一个大写字母“J”的索引
console.log(str.search(reDot)); // 返回 -1,找不到点符号“.”

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。