{"id":13475011,"url":"https://github.com/koajs/qs","last_synced_at":"2025-10-05T13:39:56.527Z","repository":{"id":12636977,"uuid":"15308438","full_name":"koajs/qs","owner":"koajs","description":"qs for koa, and use querystring more safely.","archived":false,"fork":false,"pushed_at":"2025-03-19T07:10:10.000Z","size":22,"stargazers_count":88,"open_issues_count":2,"forks_count":21,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-28T20:05:20.796Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koajs.png","metadata":{"files":{"readme":"README.md","changelog":"History.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-12-19T10:06:39.000Z","updated_at":"2025-03-19T07:10:14.000Z","dependencies_parsed_at":"2025-04-12T17:38:32.209Z","dependency_job_id":"2437af73-c9e6-4368-b01c-cbc1e884bd3f","html_url":"https://github.com/koajs/qs","commit_stats":{"total_commits":27,"total_committers":6,"mean_commits":4.5,"dds":0.5185185185185186,"last_synced_commit":"255df004f0cd4fd39a9a5926e78076b39828332d"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koajs%2Fqs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koajs%2Fqs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koajs%2Fqs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koajs%2Fqs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koajs","download_url":"https://codeload.github.com/koajs/qs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252209529,"owners_count":21712024,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T16:01:16.670Z","updated_at":"2025-10-05T13:39:51.475Z","avatar_url":"https://github.com/koajs.png","language":"JavaScript","readme":"# Koa Querystring\n\n[![NPM version][npm-image]][npm-url]\n[![build status][travis-image]][travis-url]\n[![Test coverage][coveralls-image]][coveralls-url]\n[![David deps][david-image]][david-url]\n[![node version][node-image]][node-url]\n[![npm download][download-image]][download-url]\n\n[npm-image]: https://img.shields.io/npm/v/koa-qs.svg?style=flat-square\n[npm-url]: https://npmjs.org/package/koa-qs\n[travis-image]: https://img.shields.io/travis/koajs/qs.svg?style=flat-square\n[travis-url]: https://travis-ci.org/koajs/qs\n[coveralls-image]: https://img.shields.io/coveralls/koajs/qs.svg?style=flat-square\n[coveralls-url]: https://coveralls.io/r/koajs/qs?branch=master\n[david-image]: https://img.shields.io/david/koajs/qs.svg?style=flat-square\n[david-url]: https://david-dm.org/koajs/qs\n[node-image]: https://img.shields.io/badge/node.js-%3E=_8-green.svg?style=flat-square\n[node-url]: http://nodejs.org/download/\n[download-image]: https://img.shields.io/npm/dm/koa-qs.svg?style=flat-square\n[download-url]: https://npmjs.org/package/koa-qs\n\nBy default, Koa uses the native `querystring` module which does not provide nesting support.\nThis patches a koa app with nesting support via the [qs](https://github.com/ljharb/qs) support,\nwhich is also used by Connect and Express.\n\nSimply wrap a koa app with this module:\n\n```js\n// Koa 1.x.x\nconst koa = require('koa')\nconst app = koa()\nrequire('koa-qs')(app)\n// Koa 2.x.x\nconst Koa = require('koa')\nconst app = new Koa()\nrequire('koa-qs')(app)\n```\n\n## Optional parse mode\n\nThere're three parse mode.\n\n## `extended` mode\n\nThe default mode, use [qs] module.\n\n```js\nrequire('koa-qs')(app, 'extended')\n```\n\n## `simple` mode\n\nUse `querystring` module, same as koa does by default.\nIf you want to use this mode, don't use this module.\n\n## `strict` mode\n\nThis mode make `this.query.foo` return strict `array`.\n\n```js\nrequire('koa-qs')(app, 'strict')\n```\n\n#### What's different\n\nA normal request `GET /foo?p=a\u0026q=foo\u0026q=bar`.\n\n- before patch\n\n```js\nconsole.log('%j', this.query);\n{\n  \"p\": \"a\",\n  \"q\": [\"foo\", \"bar\"]\n}\n```\n\n- after patch\n\n```js\nconsole.log('%j', this.query);\n{\n  \"p\": [\"a\"],\n  \"q\": [\"foo\", \"bar\"]\n}\n```\n\n## `first` mode\n\nThis mode make `this.query.foo` return strict `string`. Disable multi values.\n\nIf querystring contains multi same name params, return the **first** item.\n\n```js\nrequire('koa-qs')(app, 'first')\n```\n\nIn 95% use cases, application only want `string` query params.\n\nThis patch can avoid some stupid `TypeError` and some security issues like [MongoDB inject](http://www.wooyun.org/bugs/wooyun-2010-086474)\nwhen the developers forget handling query params type check.\n\n#### What's different\n\nA normal request `GET /foo?p=a,b\u0026p=b,c`.\n\n- before patch\n\n```js\nconsole.log('%j', this.query.p);\n[\"a,b\", \"b,c\"]\n```\n\n- after patch\n\n```js\nconsole.log('%j', this.query.p);\n\"a,b\"\n```\n\n## License\n\n[MIT](LICENSE)\n","funding_links":[],"categories":["JavaScript","Middleware","仓库"],"sub_categories":["中间件"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoajs%2Fqs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoajs%2Fqs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoajs%2Fqs/lists"}