← 返回首页
String.prototype.includes() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Toggle sidebar
  1. Tecnologia Web para desenvolvedores
  2. JavaScript
  3. Referência JavaScript
  4. Objetos Globais
  5. String
  6. String.prototype.includes()
Theme
  • OS default
  • Light
  • Dark
Português (do Brasil)
Remember language Learn more

Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

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 setembro de 2015.

O método includes() determina se um conjunto de caracteres pode ser encontrado dentro de outra string, retornando true ou false.

In this article

Sintaxe

str.includes(searchString[, position])

Parâmetros

searchString

É o conjunto de caracteres que será pesquisado dentro desta string.

position

Opcional. É um número inteiro que indica por onde a busca iniciará, referente ao índice da string a ser pesquisada. O valor padrão é 0.

Valor retornado

true se o conjunto de caracteres for encontrado em algum lugar dentro da string sendo pesquisada. Do contrário, retorna false.

Descrição

Este método permite conferir se uma string contém um determinado conjunto de caracteres.

Case-sensitivity

O método includes() é case sensitive. Por exemplo, a seguinte expressão retorna false:

js
"Bandeira do Brasil".includes("brasil"); // retorna false

Exemplos

Utilizando includes()

js
var str = "Ser, ou não ser, eis a questão."; console.log(str.includes("Ser")); // true console.log(str.includes("questão")); // true console.log(str.includes("não existe")); // false console.log(str.includes("ser", 1)); // true console.log(str.includes("SER")); // false

Implementação

Este método foi adicionado à especificação ECMAScript 6 e pode não estar disponível em todas as implementações JavaScript. No entanto, você pode facilmente implementar este método:

js
if (!String.prototype.includes) { String.prototype.includes = function () { "use strict"; return String.prototype.indexOf.apply(this, arguments) !== -1; }; }

Especificações

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

Enable JavaScript to view this browser compatibility table.

String.prototype.contains

No Firefox 18 - 39, o nome deste método era contains(). Ele foi renomeado para includes() no Erro do Firefox 1102219 devido ao seguinte motivo:

Foi reportado que alguns websites que utilizam MooTools 1.2 não funcionavam no Firefox 17. Esta versão do MooTools verifica se String.prototype.contains() existe e, se não existir, MooTools adiciona sua própria função. Com a implementação desta função no Firefox 17, o comportamento desta validação mudou de uma forma que códigos baseados na implementação da função String.prototype.contains() do MooTools parassem de funcionar. Como resultado, esta mudança foi desabilitada no Firefox 17 e String.prototype.contains() foi disponibilizada na versão seguinte, no Firefox 18.

MooTools 1.3 força sua própria versão do String.prototype.contains(), portanto websites baseados nela não devem parar de funcionar. No entanto, você deve notar que a assinatura do MooTools 1.3 e a assinatura ECMAScript 6 diferem (no segundo argumento). Posteriormente, MooTools 1.5+ mudou sua assinatura para o padrão ES6.

Veja também

Help improve MDN

Was this page helpful to you?
Yes No
Learn how to contribute

This page was last modified on 8 de nov. de 2023 by MDN contributors.

View this page on GitHub • Report a problem with this content
  1. Objetos Globais
  2. String
  3. Construtor
    1. String()
  4. Métodos estáticos
    1. String.fromCharCode()
    2. String.fromCodePoint()
    3. String.raw()
  5. Métodos de instância
    1. String.prototype.anchor()
    2. at()
    3. String.prototype.big()
    4. String.prototype.blink()
    5. String.prototype.bold()
    6. String.prototype.charAt()
    7. String.prototype.charCodeAt()
    8. String.prototype.codePointAt()
    9. String.prototype.concat()
    10. String.prototype.endsWith()
    11. String.prototype.fixed()
    12. String.prototype.fontcolor()
    13. String.prototype.fontsize()
    14. String.prototype.includes()
    15. String.prototype.indexOf()
    16. isWellFormed()
    17. String.prototype.italics()
    18. String.prototype.lastIndexOf()
    19. String.prototype.link()
    20. String.prototype.localeCompare()
    21. String.prototype.match()
    22. String.prototype.matchAll()
    23. String.prototype.normalize()
    24. String.prototype.padEnd()
    25. String.prototype.padStart()
    26. String.prototype.repeat()
    27. String.prototype.replace()
    28. String.prototype.replaceAll()
    29. String.prototype.search()
    30. String.prototype.slice()
    31. String.prototype.small()
    32. String.prototype.split()
    33. String.prototype.startsWith()
    34. String.prototype.strike()
    35. String.prototype.sub()
    36. String.prototype.substr()
    37. String.prototype.substring()
    38. String.prototype.sup()
    39. String.prototype.toLocaleLowerCase()
    40. String.prototype.toLocaleUpperCase()
    41. String.prototype.toLowerCase()
    42. String.prototype.toString()
    43. String.prototype.toUpperCase()
    44. toWellFormed()
    45. String.prototype.trim()
    46. String.prototype.trimEnd()
    47. String.prototype.trimStart()
    48. String.prototype.valueOf()
    49. String.prototype[@@iterator]()
  6. Propriedades de instância
    1. String.length
  7. Herança
  8. Object/Function
  9. Métodos estáticos
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.toString()
    5. [Symbol.hasInstance]()
  10. Propriedades estáticas
    1. Function.displayName
    2. Function.length
    3. Function.name
    4. prototype
    5. Function.arguments
    6. Function.caller
  11. Métodos de instância
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toString()
    10. Object.prototype.valueOf()
  12. Propriedades de instância
    1. Object.prototype.__proto__
    2. Object.prototype.constructor

Your blueprint for a better internet.

MDN Contribute Developers

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.