Buscar cabeçalhos - Escopo, Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura

    • . Buscar cabeçalhos A API permite recuperar, definir, adicionar e remover cabeçalhos de uma lista de cabeçalhos de solicitação ou resposta.

    Esta API faz parte de um conjunto de Buscar APIs, que fornecem várias ações para buscar recursos de sites externos. Completo Buscar A coleção de APIs inclui:

    Para oferecer suporte a ações de busca, a propriedade do sistema, glide.hosts.allowlist permite controles sobre o que hosts um método de busca pode acessar. Aplica-se a APIs HTTP como RestMessageV2 e os mencionados acima. Para obter mais informações sobre glide.hosts.allowlist , consulte Available system properties.

    Buscar cabeçalhos - Cabeçalhos (init)

    . Cabeçalhos () O construtor cria um novo objeto Cabeçalhos vazio. Você também pode criar e preencher previamente um novo objeto Cabeçalhos com a lista de cabeçalhos HTTP usando initparâmetro.

    Nota:
    Para adicionar cabeçalhos a um objeto Cabeçalhos existente, use Buscar cabeçalhos - anexar (nome da cadeia de caracteres, valor da cadeia de caracteres).
    Tabela 1. Parâmetros
    Nome Tipo Descrição
    inic Objeto Opcional. Um objeto literal que contém cabeçalhos HTTP para preencher previamente o novo objeto Cabeçalhos.
    Valores válidos:
    • Um objeto literal com valores de cadeia de caracteres,
    • Uma matriz de pares nome-valor,
    • Um objeto Cabeçalhos existente (em que o novo objeto copia dados do objeto existente).

    Padrão: Cria um objeto Cabeçalhos vazio

    O exemplo a seguir mostra como usar o. Cabeçalhos () Construtor para criar um novo objeto Cabeçalhos com e sem cabeçalhos.

    //Intializes an empty Headers object.
var headers = new Headers();

//Sets the new Headers object with a list of headers.
var httpHeaders = {
  "Content-Type": "application/json", 
  "X-My-Custom-Header": "XYZ", 
}; 

var myHeaders = new Headers(httpHeaders);

    Buscar cabeçalhos - anexar (nome da cadeia de caracteres, valor da cadeia de caracteres)

    Adiciona um novo valor a um cabeçalho existente dentro de um objeto Cabeçalhos ou adiciona o cabeçalho se ele ainda não existir.

    Se o cabeçalho especificado já existir, anexar() muda seu valor existente para o valor especificado. Se o cabeçalho especificado já existir e aceitar vários valores, anexar() anexa o novo valor ao final do conjunto de valores. Para substituir o valor antigo por um novo, use Buscar cabeçalhos - conjunto (nome da cadeia de caracteres, valor da cadeia de caracteres).

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Obrigatório. O nome do cabeçalho HTTP a ser adicionado ao objeto Cabeçalhos.
    valor Cadeia de caracteres Obrigatório. O valor do cabeçalho HTTP a ser adicionado.
    Tabela 3. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como adicionar um cabeçalho usando anexar() :

    var myHeaders = new Headers(); // Currently empty
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'

    Saída:

    “image/jpeg”

    O exemplo a seguir mostra como anexar um novo cabeçalho que aceita vários valores:

    var myHeaders = new Headers(); // Currently empty
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns 'deflate, gzip'

    Saída:

    {“deflate”, “gzip”}

    Buscar cabeçalhos - delete (nome da cadeia de caracteres)

    Exclui um cabeçalho do objeto Cabeçalhos atual.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres O nome do cabeçalho HTTP a ser excluído do objeto Cabeçalhos.
    Tabela 5. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como adicionar primeiro um cabeçalho ao objeto Cabeçalhos usando anexar() e exclua o mesmo cabeçalho usando excluir() .

    var myHeaders =newHeaders();// Currently empty
myHeaders.append("Content-Type","image/jpeg");
myHeaders.get("Content-Type");// Returns 'image/jpeg'

    O exemplo a seguir mostra que o endpoint retorna um valor nulo se o objeto Cabeçalhos já tiver sido excluído:

    myHeaders.delete("Content-Type");
myHeaders.get("Content-Type");// Returns null, as it has been deleted

    Saída:

    null

    Buscar cabeçalhos - Entradas ()

    Retorna um iterador que permite percorrer todos os pares de chave-valor (representados por cadeias de caracteres) contidos no objeto Cabeçalhos.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 7. Retorna
    Tipo Descrição
    Iterador Retorna um objeto iterador, em que os pares de chave e valor são objetos de cadeia de caracteres.

    O exemplo a seguir mostra como criar um objeto Cabeçalhos de teste e usar o. entradas () Método para retornar um iterador de todos os valores no objeto Cabeçalhos.

    // Create a test Headers object
var myHeaders = new Headers();
myHeaders.append("Content-Type", "text/xml");
myHeaders.append("Vary", "Accept-Language");

// Display the key/value pairs
for (var pair of myHeaders.entries()) {
  console.log(`${pair[0]}: ${pair[1]}`);
}

    Saída:

    content-type: text/xml
vary: Accept-Language

    Buscar cabeçalhos - foreach(function callbackFn, Object thisArg)

    Executa uma função de retorno de chamada uma vez por cada par de chave/valor no objeto Cabeçalhos.

    A função de retorno de chamada não é executada para chaves excluídas, mas sim para chaves existentes, mesmo se o valor for indefinido.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    CallbackFn Função Função a ser executada para cada par de chave/valor no objeto Cabeçalhos.

    Em conformidade com o formato: CallbackFn(chave da cadeia de caracteres, valor da cadeia de caracteres) .
    CallbackFn.value Cadeia de caracteres Valor da entrada do cabeçalho.
    callbackFn.key Cadeia de caracteres Nome da entrada do cabeçalho.
    CallBackFn.object Cabeçalho O objeto Cabeçalhos a ser iterado.
    EsteArg Objeto Valor a ser usado como isso ao executar retorno de chamada .
    Tabela 9. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir registra em log uma linha para cada par de chave/valor no objeto Cabeçalhos:

    // Create a new test Headers object
var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Cookie", "This is a demo cookie");
myHeaders.append("compression", "gzip");

// Display the key/value pairs
myHeaders.forEach((value, key) => {
  console.log(`${key} ==> ${value}`);
});

    Saída:

    compression ==> gzip
content-type ==> application/json
cookie ==> This is a demo cookie

    Buscar cabeçalhos - GET (nome da cadeia de caracteres)

    Retorna uma cadeia de caracteres de todos os valores de cabeçalho de um objeto Cabeçalhos especificado ou retorna nulo se o cabeçalho não existir.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres O nome do cabeçalho HTTP cujos valores de cabeçalho você deseja recuperar (não diferencia maiúsculas de minúsculas).
    Tabela 11. Retornos
    Tipo Descrição
    Cadeia de caracteres O valor do cabeçalho recuperado (representado como uma cadeia de caracteres) ou nulo se o cabeçalho não estiver definido.

    Retorna um erro se o cabeçalho não existir. Retorna um erro de tipo se o nome fornecido não for o de um cabeçalho HTTP.

    A seguir, é mostrado como criar um objeto de cabeçalhos com vários cabeçalhos usando anexar() e, em seguida, retornar os valores do cabeçalho usando get() método.

    var myHeaders = new Headers(); // Currently empty
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns "deflate, gzip"
myHeaders
  .get("Accept-Encoding")
  .split(",")
  .map((v) => v.trimStart()); // Returns [ "deflate", "gzip"

    Saída:

    [ "deflate", "gzip" ]

    Buscar cabeçalhos - getSetCookie()

    Retorna todos os cabeçalhos Set-Cookie associados a uma resposta.

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 13. Retorna
    Tipo Descrição
    Matriz de cadeias de caracteres Uma matriz de cadeias de caracteres que contém os valores de todos os cabeçalhos Set-Cookie associados a uma resposta. O método retornará uma matriz vazia se nenhum cabeçalho Set-Cookie estiver definido.

    O exemplo de script a seguir mostra como usar GetSetCookie() para retornar os valores de cabeçalho associados à resposta:

    var headers = new Headers({
  "Set-Cookie": "name1=value1",
});

headers.append("Set-Cookie", "name2=value2");

headers.getSetCookie();

    Saída:

    ["name1=value1", "name2=value2"]

    Buscar cabeçalhos - has (nome da cadeia de caracteres)

    Retorna um booliano que indica se um objeto Cabeçalhos contém o cabeçalho fornecido.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres O nome do cabeçalho HTTP para verificar se ele existe no objeto Cabeçalhos ou não.
    Tabela 15. Retornos
    Tipo Descrição
    Booliano Sinalizador que indica se o cabeçalho especificado existe no objeto Cabeçalhos. Um TypeError será retornado se o cabeçalho fornecido não for um nome de cabeçalho HTTP válido.
    Valores possíveis:
    • Verdadeiro: O cabeçalho existe no objeto.
    • Falso: O cabeçalho não existe no objeto.

    O exemplo a seguir usa Cabeçalhos () e. anexar() Métodos para criar e definir um objeto Cabeçalhos com o cabeçalho Content-Type. Em seguida, o exemplo usa () Método para mostrar que o cabeçalho Content-Type existe no objeto Cabeçalhos, mas um cabeçalho Accept-Coding não.

    var myHeaders = new Headers(); // Currently empty
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.has("Content-Type"); // Returns true
myHeaders.has("Accept-Encoding"); // Returns false

    Saída:

    true
false

    Buscar cabeçalhos - Chaves ()

    Retorna um iterador que permite percorrer todas as chaves contidas em um objeto Cabeçalhos.

    Use Buscar cabeçalhos - Valores () método para retornar todas as chaves de cabeçalho.

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 17. Retorna
    Tipo Descrição
    Iterador Retorna um iterador, em que as chaves de cabeçalho são representadas como cadeias de caracteres.

    O exemplo a seguir mostra como criar um objeto Cabeçalhos com chaves e usar o. chaves () método para retornar uma lista de cabeçalhos disponíveis.

    // Create a test Headers object
var myHeaders = new Headers();
myHeaders.append("Content-Type", "text/xml");
myHeaders.append("Vary", "Accept-Language");

// Display the keys
for (var key of myHeaders.keys()) {
  console.log(key);
}

    Saída:

    content-type
vary

    Buscar cabeçalhos - conjunto (nome da cadeia de caracteres, valor da cadeia de caracteres)

    Atualiza um valor de um cabeçalho existente dentro do objeto Cabeçalhos ou cria um novo cabeçalho com o valor fornecido se o cabeçalho ainda não existir.

    Para simplesmente anexar um novo valor a um cabeçalho existente sem substituir dados, use Buscar cabeçalhos - anexar (nome da cadeia de caracteres, valor da cadeia de caracteres) método.

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres O nome do cabeçalho HTTP no qual definir um novo valor. Lança TypeError se o nome fornecido não for o nome de um cabeçalho HTTP.
    valor Cadeia de caracteres O novo valor a ser definido para o cabeçalho fornecido.
    Tabela 19. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir um cabeçalho no novo objeto Cabeçalhos usando anexar() e, em seguida, redefina o valor usando set() .

    var myHeaders = new Headers(); // Currently empty
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.set("Content-Type", "text/html");

    Saída:

    text/html

    O exemplo a seguir mostra como definir um valor em um objeto Cabeçalhos quando ele aceita vários valores:

    myHeaders.set("Accept-Encoding", "deflate");
myHeaders.set("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding");

    Saída:

    gzip

    Buscar cabeçalhos - Valores ()

    Retorna um iterador que permite percorrer todos os valores de cabeçalho contidos no objeto Cabeçalhos.

    Use Buscar cabeçalhos - Chaves () método para retornar todos os valores de cabeçalho.

    Tabela 20. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 21. Retorna
    Tipo Descrição
    Cadeia de caracteres Retorna um iterador, em que os valores do cabeçalho são representados como cadeias de caracteres.

    O exemplo a seguir mostra como criar e definir primeiro um novo objeto Cabeçalhos com vários cabeçalhos usando anexar() e retorna uma lista de todos os valores de cabeçalho no novo objeto chamando valores () método. Console.log() registra a linha nos logs do sistema.

    // Create a test Headers object
var myHeaders = new Headers();
myHeaders.append("Content-Type", "text/xml");
myHeaders.append("Vary", "Accept-Language");

// Display the values
for (var value of myHeaders.values()) {
  console.log(value);
}

    Saída:

    text/xml
Accept-Language