HOWTO · JavaScript
PHP `preg_match()`에 해당하는 JavaScript 메서드: `test()`와 `match()`
이 기사에서는 preg_match 함수의 목적이 무엇인지, 예제를 통해 JavaScript에서 동일한 기능을 구현하는 가능한 방법은 무엇인지 알아보겠습니다.
이 페이지의 내용
JavaScript에서 preg_match()를 검색하는 경우는 대개 문자열을 정규식으로 검사하거나 일치하는 텍스트를 가져오려는 경우입니다. JavaScript에는 preg_match()라는 내장 함수가 없습니다. 참·거짓 결과가 필요하면 RegExp.prototype.test()를, 일치 정보를 확인하려면 String.prototype.match()를 사용하세요. 적절한 방법은 다음 코드에서 무엇을 해야 하는지에 따라 달라집니다.
PHP의 preg_match() 이해하기
PHP의 preg_match()에는 패턴과 대상 문자열을 전달하며, 세 번째 인수로 일치 정보를 선택적으로 받을 수 있습니다. 구문은 preg_match($pattern, $subject, $matches)입니다.
반환값은 단순한 불리언이 아닙니다. 패턴이 일치하면 1, 일치하지 않으면 0, 오류가 발생하면 false를 반환합니다. 선택적 $matches 인수에는 일치할 때 캡처된 텍스트가 담깁니다. 조건을 다른 언어로 옮길 때 이 차이가 중요합니다. JavaScript의 test()는 불리언을 반환하지만, match()는 일치 정보 또는 null을 반환합니다.
JavaScript 대안 선택하기: test() 또는 match()
JavaScript에는 이에 직접 대응하는 preg_match() 함수가 없습니다. test()와 match()는 모두 JavaScript 정규식을 사용하지만, 서로 다른 질문에 답합니다. 이후 코드에서 패턴이 문자열에 있는지만 알면 된다면 test()를 선택하세요. 일치한 부분 문자열, 캡처 그룹 또는 일치 위치가 필요하다면 match()를 선택하세요. PHP처럼 참·거짓으로 확인하려면 test()를 사용하고, 선택적 $matches 데이터가 필요하다면 반환 형태가 다르다는 점을 고려해 match()를 사용하세요.
참·거짓으로 일치 여부를 확인할 때 test() 사용하기
정규식에서 test()를 호출하고 검사할 문자열을 전달하세요. 표현식이 문자열의 어느 위치에서든 일치하면 true, 그렇지 않으면 false를 반환합니다. 다음 예제는 텍스트에 hello라는 단어가 있는지 확인합니다.
다음 예제를 실행하세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
const pattern = /hello/;
const text = "hello world";
console.log(pattern.test(text));
true
제공된 실행에서 이 예제는 true를 출력했습니다. 반대 결과를 확인하려면 hello가 없는 문자열을 사용해 보세요. JavaScript의 test() 동작에 따라 호출 결과는 false가 됩니다. 이 방법은 유효성 검사 조건에 유용하지만, 패턴 자체가 의도한 형식 전체를 표현해야 합니다. 예를 들어 숫자를 찾기만 하는 패턴은 입력 전체가 숫자로만 이루어졌다는 뜻이 아닙니다. 문자열 전체가 일치해야 한다면 앵커를 사용하세요.
일치 항목을 가져올 때 match() 사용하기
문자열에서 match()를 호출하고 정규식을 전달하세요. g 플래그가 없는 정규식은 일치 항목이 있으면 전체 일치 문자열을 첫 번째 요소로 포함하는 배열을 반환합니다. 캡처 그룹과 index 같은 속성에서 추가 정보를 얻을 수 있습니다. 일치 항목이 없으면 결과는 null이므로 배열 속성을 읽기 전에 null인지 확인하세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
const text = "Order 42 is ready";
const result = text.match(/Order (\d+)/);
if (result !== null) {
console.log(result[0]);
console.log(result[1]);
console.log(result.index);
} else {
console.log("No match");
}
Order 42
42
0
제공된 실행에서 이 예제는 전체 일치 문자열 Order 42, 캡처된 숫자 42, 시작 인덱스 0을 출력했습니다. 패턴이 일치하지 않으면 result는 null이 되고 대체 분기가 실행됩니다. PHP의 선택적 $matches 인수와 달리 JavaScript는 메서드 호출에서 결과를 직접 반환합니다.
플래그와 흔한 주의 사항 처리하기
JavaScript 정규식의 플래그는 일치 동작을 바꿉니다. 기본적으로 대소문자를 구분하며, /hello/i처럼 i를 추가하면 대소문자를 구분하지 않습니다. g 플래그는 match()의 결과 형태를 바꿉니다. text.match(/\d+/g)는 일치하는 모든 숫자 문자열을 배열로 반환하며, 일치 항목이 없으면 null을 반환합니다. 이 전역 검색 방식의 결과에는 비전역 match() 호출에서 얻을 수 있는 각 일치 항목의 index와 캡처 그룹 정보가 포함되지 않습니다. 특정 일치 항목의 캡처 그룹과 위치가 필요하다면 비전역 정규식을 사용하세요.
g 또는 y 플래그가 있는 정규식을 test()와 함께 재사용할 때는 주의하세요. 이런 정규식은 lastIndex 위치를 기억하므로 검색 위치가 이동하면서 반복 호출 결과가 번갈아 달라질 수 있습니다. 서로 독립적인 간단한 참·거짓 확인에는 상태를 유지하는 플래그를 생략하거나 매번 확인하기 전에 lastIndex를 초기화하세요. 또한 ., *, ? 같은 문자는 패턴에서 특별한 의미가 있습니다. 문자 그대로 일치시키려면 앞에 백슬래시를 붙여 이스케이프하세요. 부분 문자열이 아니라 전체 문자열이 패턴을 만족해야 한다면 ^와 $ 같은 앵커를 사용하세요.