From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../global_objects/regexp/test/index.html | 152 +++++++++++++++++++++ 1 file changed, 152 insertions(+) create mode 100644 files/pt-br/web/javascript/reference/global_objects/regexp/test/index.html (limited to 'files/pt-br/web/javascript/reference/global_objects/regexp/test') diff --git a/files/pt-br/web/javascript/reference/global_objects/regexp/test/index.html b/files/pt-br/web/javascript/reference/global_objects/regexp/test/index.html new file mode 100644 index 0000000000..c3470dc4fe --- /dev/null +++ b/files/pt-br/web/javascript/reference/global_objects/regexp/test/index.html @@ -0,0 +1,152 @@ +--- +title: RegExp.prototype.test() +slug: Web/JavaScript/Reference/Global_Objects/RegExp/test +tags: + - Expressão Regular + - JavaScript + - Prototype + - Referencia + - RegExp + - metodo +translation_of: Web/JavaScript/Reference/Global_Objects/RegExp/test +--- +
{{JSRef}}
+ +
O método test() executa uma busca por uma correspondência entre  uma expressão regular e uma string. Retorna true ou false.
+ +

Sintaxe

+ +
regexObj.test(str)
+ +

Parâmetros

+ +
+
str
+
A string que confrontará a expressão regular.
+
+ +

Retorno

+ +

Boolean.

+ +

true se a string str corresponde com o que está descrito na expressão regular.

+ +

Caso contrário, retorna false.

+ +

Descrição

+ +

Use test() sempre que você quiser saber se um padrão está dentro de uma string( similar ao método {{jsxref("String.prototype.search()")}}); Para mais informações (porém com execução mais lenta) use o método {{jsxref("RegExp.prototype.exec()", "exec()")}} (similar ao método {{jsxref("String.prototype.match()")}}). Assim como {{jsxref("RegExp.prototype.exec()", "exec()")}} (ou em combinação com ele), test() quando chamado várias vezes dentro da mesma instância de expressão regular irá avançar seu ponteiro para a correspondência anterior.

+ +

Exemplos

+ +

Usando test()

+ +

Exemplo simples que verifica se "hello" está presente no início de uma string, retornando um booleano como resultado.

+ +
const str = 'hello world!';
+const result = /^hello/.test(str);
+
+console.log(result); // true
+ +

O exemplo a seguir mostra uma mensagem dependendo do sucesso do teste.

+ +
function testinput(re, str){
+  var midstring;
+  if (re.test(str)) {
+    midstring = ' Contém ';
+  } else {
+    midstring = ' não contém ';
+  }
+  console.log(str + midstring + re.source);
+}
+
+ +

Specificações

+ + + + + + + + + + + + + + + + + + + + + + + + +
SpecificaçõesStatusComentário
{{SpecName('ES3')}}{{Spec2('ES3')}}Definição inicial. Implementado no JavaScript 1.2.
{{SpecName('ES5.1', '#sec-15.10.6.3', 'RegExp.test')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-regexp.prototype.test', 'RegExp.test')}}{{Spec2('ES6')}}
+ +

Compatibilidade com Browser

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureChromeFirefox (Gecko)Internet ExplorerOperaSafari
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
FeatureAndroidChrome para AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Basic support{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

Gecko-specific notes

+ +

A priori no Grecko 8.0 {{geckoRelease("8.0")}}, test() foi implementado incorretamente; quando chamado sem parâmetros, ele encontrária uma correspondência com o valor de entrada anterior (RegExp.input property) no lugar de uma correspondência com "undefined". Isso está conrrigido; agora /undefined/.test() resultará em true, no lugar de um erro.

+ +

See also

+ + -- cgit v1.2.3-54-g00ecf