String.prototype.includes()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

includes() 메서드는 하나의 문자열이 다른 문자열에 포함되어 있는지를 판별하고, 결과를 true 또는 false 로 반환합니다. 검색 시 대소문자를 구분합니다.

시도해보기

const sentence = "The quick brown fox jumps over the lazy dog.";

const word = "fox";

console.log(
  `The word "${word}" ${
    sentence.includes(word) ? "is" : "is not"
  } in the sentence`,
);
// Expected output: "The word "fox" is in the sentence"

구문

js
includes(searchString)
includes(searchString, position)

매개변수

searchString

이 문자열에서 찾을 다른 문자열. 정규표현식이 올 수 없습니다.

position Optional

searchString을 찾기 시작할 위치. (기본값 0).

반환값

문자열을 찾아내면 true . 실패하면 false .

예외

TypeError

searchString정규식일 경우.

설명

이 메서드를 사용해 문자열 내에 찾고자 하는 다른 문자열이 있는지 확인할 수 있습니다.

대소문자 구분

includes() 메서드는 대소문자를 구별합니다. 예를 들어 아래 코드는 false를 반환합니다.

js
"Blue Whale".includes("blue"); // returns false

아래와 같이 원본 문자열과 검색 문자열을 모두 소문자로 변환하여 이 제약 조건을 해결할 수 있습니다.

js
"Blue Whale".toLowerCase().includes("blue"); // returns true

예제

includes() 사용하기

js
const str = "To be, or not to be, that is the question.";

console.log(str.includes("To be")); // true
console.log(str.includes("question")); // true
console.log(str.includes("nonexistent")); // false
console.log(str.includes("To be", 1)); // false
console.log(str.includes("TO BE")); // false
console.log(str.includes("")); // true

명세

Specification
ECMAScript® 2025 Language Specification
# sec-string.prototype.includes

브라우저 호환성

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
includes

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Uses a non-standard name.
Has more compatibility info.

같이 보기