String.
Sprawdza, czy napis zawiera podany fragment tekstu. Zwraca true albo false i rozróżnia wielkość liter.
- Zwraca
true, jeśli fragment występuje w napisie, w przeciwnym raziefalse.- Zmienia oryginał
- Nie
Przykład
#const description = 'Kurs JavaScript dla początkujących'
console.log(description.includes('JavaScript'))
console.log(description.includes('javascript'))
console.log(description.includes('Python'))Definicja i zastosowanie
#Metoda includes() odpowiada na proste pytanie: czy w tym tekście występuje dany fragment? Zwraca true lub false, więc świetnie nadaje się do warunków if i filtrowania list.
Porównanie rozróżnia wielkość liter, więc "JavaScript".includes("script") zwraca false. Aby szukać bez względu na wielkość liter, zamień obie strony na małe litery. Drugi, opcjonalny argument wskazuje indeks, od którego zaczyna się szukanie.
Metoda przyjmuje tylko tekst. Przekazanie wyrażenia regularnego kończy się błędem TypeError, bo do wzorców służą match() i RegExp.prototype.test(). Pusty napis "" jest zawarty w każdym tekście.
Składnia
#string.includes(searchString)
string.includes(searchString, position)Parametry
#searchString
string
Szukany fragment. Wyrażenie regularne powoduje błądTypeError.position
number, opcjonalny
Indeks, od którego zaczyna się szukanie. Domyślnie0.
Więcej przykładów
#const lessons = ['Zmienne i typy', 'Pętle for', 'Funkcje strzałkowe']
const query = 'PĘTLE'
const found = lessons.filter((lesson) => lesson.toLowerCase().includes(query.toLowerCase()))
console.log(found)const code = 'let a = 1; let b = 2'
console.log(code.includes('let', 1))
console.log(code.includes('let', 12))const comment = 'Świetna lekcja, ale za mało przykładów'
const keywords = ['błąd', 'przykład', 'niejasne']
console.log(keywords.some((word) => comment.includes(word)))Obsługa przeglądarek
#Szeroko dostępne
Działa we wszystkich nowoczesnych przeglądarkach, także na telefonach. Możesz używać bez obaw.
- Chrome
- Edge
- Firefox
- Safari
Dobre praktyki
#- Do sprawdzania początku lub końca tekstu czytelniejsze są
startsWith()iendsWith(). - Jeśli potrzebujesz pozycji znalezionego fragmentu, a nie tylko odpowiedzi tak lub nie, użyj
indexOf().
Powiązane hasła
#- String.prototype.indexOf()Zwraca indeks pierwszego wystąpienia podanego tekstu w napisie albo -1, gdy go nie ma.
- String.prototype.startsWith()Sprawdza, czy napis zaczyna się od podanego tekstu. Zwraca true albo false.
- String.prototype.endsWith()Sprawdza, czy napis kończy się podanym tekstem. Zwraca true albo false.
- String.prototype.match()Dopasowuje napis do wyrażenia regularnego. Zwraca tablicę z dopasowaniem lub wszystkimi dopasowaniami albo null.
- Array.prototype.includes()Sprawdza, czy tablica zawiera podaną wartość.
Widzisz błąd albo brakuje przykładu? Napisz do nas.