String 값의search() 메서드는 정규식과 이 문자열 간에 일치하는 항목이 있는지 검색하여문자열에서 첫 번째로 일치하는 항목의 인덱스를 반환합니다.

시도해 보기

const paragraph = "I think Ruth's dog is cuter than your dog!";// Anything not a word character, whitespace or apostropheconst regex = /[^\w\s']/g;console.log(paragraph.search(regex));// Expected output: 41console.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[@@search]()에서 가져옵니다.

regexp의g 플래그는search() 결과에 아무런 영향을 미치지 않으며, 검색은 항상 정규식의lastIndex가 0인 것처럼 수행됩니다.search()의 동작에 대한 자세한 내용은RegExp.prototype[@@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)); // 첫 대문자 "J"의 인덱스인 4를 반환합니다.console.log(str.search(reDot)); // '.' 을 찾을 수 없어서 -1을 반환합니다.

명세서

브라우저 호환성

같이 보기

• Polyfill ofString.prototype.search incore-js with fixes and implementation of modern behavior likeSymbol.search support
• 정규 표현식 가이드
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype[@@search]()