getCookieByName

Obtém o valor de um cookie pelo nome usando uma expressão regular.

API

getCookieByName

Retorna

Argumento Descrição Tipo
string O valor do cookie; string vazia se não existir string

Parâmetros

Parâmetro Descrição Tipo Padrão
name Nome do cookie string Obrigatório

Exemplo

Uso básico

import { getCookieByName } from 'ranuts';

const token = getCookieByName('token');
console.log(token); // O valor do cookie, ou uma string vazia

No que difere de getCookie

import { getCookie, getCookieByName } from 'ranuts';

// getCookie divide a string
const value1 = getCookie('token');

// getCookieByName usa uma expressão regular
const value2 = getCookieByName('token');

// Fazem o mesmo; muda só a implementação
import { getCookieByName } from 'ranuts';

const sessionId = getCookieByName('sessionId');
if (sessionId) {
  console.log('ID da sessão:', sessionId);
} else {
  console.log('O ID da sessão não existe');
}

Notas

  1. Casamento por expressão regular: procura o cookie com uma expressão regular, então tolera espaços antes ou depois do nome.
  2. Seguro no servidor: em ambientes de servidor (sem objeto window) devolve string vazia e não lança erros.
  3. Diferença para getCookie: fazem o mesmo, mas getCookieByName usa expressão regular e getCookie divide a string.
  4. Valor devolvido: quando o cookie não existe, devolve string vazia, não null nem undefined.