fast-qs



> A lightweight library for parsing and stringifying URL query strings.

---

Documentation

For detailed usage instructions and API references, please visit the official documentation:

👉 View Full Documentation

---

Quick Start

``typescript
import { parse, stringify } from 'fast-qs';

// Parse a query string
const params = parse('name=John&age=30');
console.log(params); // → { name: 'John', age: '30' }

// Stringify an object
const query = stringify({ city: 'New York', country: 'USA' });
console.log(query); // → "city=New%20York&country=USA"
`

---

Core Features

$3


| Feature | Description |
|------------------------|----------------------------------------------------------------------------|
| Custom Separators | Support any separators (e.g., parse('a|1;b|2', { sep: ';', eq: '|' }) |
| Empty Value Handling | f= → { f: '' }, &= → { '': '' } |
| Duplicate Keys | Automatically converted to arrays (e.g., a=1&a=2 → { a: ['1', '2'] } |
| Invalid Encoding | Retains invalid %xx (e.g., % → %, %A → %A |
| URL Parsing | Automatically extracts parameters after ?, supports start to specify position |
| Filter Extension | Filter/transform keys/values via filter` (e.g., filter sensitive fields) |

---

Contributing

We welcome contributions from the community! If you find a bug or want to suggest an improvement, feel free to open an issue or submit a pull request.

$3

1. Fork the repository.
2. Create a new branch for your changes.
3. Submit a pull request with a clear description of your changes.

---

License

This project is licensed under the MIT License.

---

Browser Support

!Chrome | !Firefox | !Safari | !Opera | !Edge |
--- | --- | --- | --- | --- |
Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ | Latest ✔ |