nginstack

Module: @nginstack/engine/lib/net/XMLHttpRequest

Classes

XMLHttpRequest

Type Definitions

XHRConfig

Objeto literal com configurações opcionais. Em propriedades onde são informadas um path são válidos caminhos de arquivos do Sistema Operacional, assim como de arquivos da Virtual File System(prefixado por 'vfs:').

Type:
  • Object
Properties:
Name Type Argument Description
keyPath string <optional>

Path do arquivo contendo uma chave privada RSA no formato PEM
certPath string <optional>

Path do arquivo contendo Certificado cliente no formato PEM
pfxPath string <optional>

Path para um arquivo PKCS#12(pfx). As propriedades keyPath e certPath não devem ser informadas, caso a propriedade pfxPath seja definida.
passphrase string <optional>

Senha usada para decodificar a chave privada ou o arquivo pfx
ignoreSslErrors boolean <optional>

Se verdadeiro, não será validado o certificado do servidor remoto. Importante: ativar essa opção desativa a proteção do protocolo HTTPS, tornando a comunicação vulnerável para ataques de interceptação. Essa opção deve ser utilizada apenas para testes em ambientes controlados. Em produção, o certificado do servidor sempre deve ser validado. Caso esteja tendo problemas com certificados digitais, consulte a dúvida "Como diagnosticar erros de configuração de certificados digitais?" em https://nginstack.com/faq/engine/.
proxy string <optional>

Configuração do servidor proxy a ser utilizado na requisição HTTP. Deve ser informado o endereço de um servidor proxy, como "socks5://host:port", ou os valores especiais "auto" e "no_proxy". O valor "auto" indica que deve ser utilizado o servidor proxy definido no sistema operacional por meio das variáveis de ambiente HTTP_PROXY e HTTPS_PROXY, e o valor "no_proxy" desabilita o uso do proxy. Caso não seja informada, será utilizada a configuração de proxy padrão do sistema, definida pela variável de ambiente ENGINE_PROXY ou pela opção de linha de comando --NoProxy.
forceHttp1 boolean <optional>

Força o uso do protocolo HTTP/1.1, mesmo quando o servidor remoto indica que versões mais avançadas do protocolo HTTP são suportadas. Essa opção é útil para contornar problemas na comunicação com servidores que não implementam corretamente a extensão Application-Layer Protocol Negotiation (ALPN), utilizada na negociação da versão do protocolo HTTP. Em geral, esta opção não deve ser utilizada.
useNativeTls boolean <optional>

Indica que a implementação nativa de TLS do sistema operacional, Schannel no Windows e OpenSSL no Linux, deve ser utilizada para estabelecer conexões seguras em vez da biblioteca TLS padrão embarcada no Engine. Esta opção pode ser utilizada para contornar problemas de compatibilidade com servidores que não suportam o protocolo TLS 1.2 ou superior, exigido pela biblioteca TLS padrão.