qs

qs é uma biblioteca JavaScript amplamente utilizada para analisar e serializar query strings, com suporte a objetos aninhados, arrays e várias opções de formatação. Originalmente criada por TJ Holowaychuk e agora mantida por Jordan Harband, ela fornece um tratamento robusto de parâmetros de URL comumente encontrados em aplicações web e APIs. A funcionalidade central da biblioteca concentra-se em duas operações principais: analisar query strings em objetos JavaScript e serializar objetos de volta em query strings. A análise suporta estruturas de objetos aninhados usando notação de colchetes (por exemplo, 'foo[bar]=baz' torna-se { foo: { bar: 'baz' } }), com limites de profundidade configuráveis (padrão de 5 níveis) para evitar abuso de entradas profundamente aninhadas. Arrays podem ser analisados usando notação de colchetes ('a[]=b&a[]=c') ou notação indexada ('a[0]=b&a[1]=c'), com compactação automática de arrays esparsos e limites de array configuráveis (padrão de 20 elementos). Recursos de segurança são proeminentemente incorporados ao qs. A biblioteca impõe limites de profundidade, limites de parâmetros (padrão de 1000) e limites de array para mitigar possíveis abusos ao analisar entradas não confiáveis. A opção strictDepth pode lançar erros quando os limites de profundidade são excedidos, e throwOnLimitExceeded fornece erros descritivos para qualquer violação de limite. A proteção contra poluição de protótipo é tratada através da opção plainObjects (criando objetos com protótipo nulo) ou allowPrototypes (que deve ser usada com cautela). A biblioteca também suporta detecção de charset via charsetSentinel para lidar com cenários de codificação legados. As opções de configuração são extensas, cobrindo personalização de delimitadores (string ou regex), suporte a notação de ponto (allowDots), análise de arrays separados por vírgula, estratégias de tratamento de chaves duplicadas (combine, first, last) e várias personalizações de codificação/decodificação. A função stringify suporta múltiplos formatos de array (indices, brackets, repeat, comma), codificadores/decodificadores personalizados, serialização de datas, ordenação de chaves e filtragem. Opções como encodeValuesOnly, addQueryPrefix e allowEmptyArrays fornecem controle fino sobre a formatação da saída. A biblioteca é projetada para uso em ambientes Node.js e é comumente integrada a frameworks web como Express para lidar com parâmetros de query de requisições. Seu conjunto abrangente de recursos, considerações de segurança e documentação extensa a tornam uma escolha confiável para o tratamento de query strings em aplicações de produção.