Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

RegExp: classes de caracteres, quantificadores e âncoras

Define o que pode corresponder ao padrão, quantas vezes se pode repetir e em que posição. Combina estes elementos para validar uma cadeia inteira ou encontrar uma linha correspondente.

Versão: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxe

Character classes: [...], [^...], [a-z], \d, \D, \w, \W, \s, \S
Unicode property escapes with u or v: \p{Letter}, \P{Letter}
Class syntax with v: [A&&B], [A--B], [\q{ab|cd}]
Wildcard: . (includes line terminators with s)
Quantifiers after an atom: *, +, ?, {n}, {n,}, {n,m}; append ? for lazy repetition
Anchors and boundary assertions: ^, $, \b, \B
Example pattern: /^[A-Z]{2}-\d{2}$/

Classes de caracteres. [abc] corresponde a um carácter do conjunto, [a-z] inclui ambos os extremos do intervalo e [^abc] corresponde a um carácter fora do conjunto. \d corresponde a um algarismo ASCII, \s a um carácter de espaço em branco (incluindo terminadores de linha) e \w a uma letra ASCII, um algarismo ASCII ou um sublinhado. Com i e u ou v, \w também inclui os caracteres que o case folding Unicode mapeia para esse conjunto. \D, \S e \W são os complementos respetivos. Fora de parênteses retos, . exclui os terminadores de linha, exceto com s; [.] corresponde a um ponto literal.

Unicode. Sem u nem v, o padrão opera sobre unidades de código UTF-16; com um deles, opera sobre pontos de código, não sobre grupos de grafemas. \p{Letter} e \P{Letter} exigem u ou v e correspondem, respetivamente, a letras Unicode e a caracteres que não são letras. v acrescenta a interseção (&&), a diferença (--) e os conjuntos finitos de cadeias, como [\q{ab|cd}]. Não combines u e v; confirma se o ambiente de destino suporta v.

Quantificadores. Aplicam-se apenas ao átomo anterior; usa (?:ab)+ para repetir a sequência inteira. * significa zero ou mais repetições, + uma ou mais, ? zero ou uma, {n} exatamente n, {n,} pelo menos n e {n,m} entre n e m, inclusive. Um mínimo superior ao máximo provoca um SyntaxError. Um quantificador guloso tenta primeiro mais repetições; um ? no fim, como em +?, inverte essa preferência. O resto do padrão pode exigir outra quantidade.

Âncoras e limites. Verificam uma posição sem consumir caracteres. Sem m, ^ e $ indicam o início e o fim de toda a cadeia; $ não corresponde à posição antes de um terminador de linha final. Com m, correspondem também imediatamente depois e antes de um terminador de linha, respetivamente. \b verifica se apenas um dos lados é um carácter \w; fora da cadeia não há caracteres de palavra. \B verifica o contrário. Dentro de uma classe, \b representa o carácter de retrocesso. Para validar toda a cadeia com alternativas, agrupa-as como em ^(?:yes|no)$ e não uses m.

Exemplos

const whole = /^[A-Z]{2}-\d{2}$/;
const line = /^[A-Z]{2}-\d{2}$/m;

console.log(whole.test("AB-42"));
console.log(whole.test("Ab-42"));
console.log(whole.test("AB-4"));
console.log(whole.test("AB-42\n"));
console.log(line.test("header\nAB-42\nfooter"));

Resultado

true
false
false
false
true

`whole` exige duas letras maiúsculas ASCII, um hífen e dois algarismos ASCII. Rejeita uma minúscula, a falta de um algarismo e uma mudança de linha no fim. Com `m`, `line` encontra o código válido na linha do meio.

Lições relacionadas

  • JavaScript · Lição 25 · Intermédio · Versão: 3

Fontes