# @ghostery/url-parser

> A Fast URL parser implementation

Latest version **1.3.1** (published 2026-01-09) · MPL-2.0 license · 0 weekly downloads

## Install

```sh
npm install @ghostery/url-parser
pnpm add @ghostery/url-parser
yarn add @ghostery/url-parser
bun add @ghostery/url-parser
```

## Health

**Score 65/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; has provenance; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.3.1 |
| Published | 2026-01-09 |
| First published | 2024-10-17 |
| Weekly downloads | 0 |
| License | MPL-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 219.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | Sam Macbeth |
| Maintainers | chrmod, smalluban |

## Links

- npm: https://www.npmjs.com/package/@ghostery/url-parser
- Repository: https://github.com/ghostery/url-parser
- Homepage: https://github.com/ghostery/url-parser#readme
- Issues: https://github.com/ghostery/url-parser/issues
- npm.io page: https://npm.io/package/@ghostery/url-parser

## Dependencies (1)

- [tldts-experimental](https://npm.io/package/tldts-experimental.md) ^7.0.8

## Recent versions

- 1.3.1 (latest) — 2026-01-09
- 1.3.0 — 2025-06-12
- 1.2.0 — 2025-05-29
- 1.1.6 — 2024-10-17

## README

# Ghostery Url Parser

A Fast implementation of url parsing, mostly API-compatible with the standard URL class while
being on average 2-3 times faster. Evaluation of URL components is lazy, so this implementation
should be fast for all read use-cases.

Known differences to standard URL:
 * Parameters returned via `URL.searchParams.entries()` are decoded only with
   `decodeURIComponent`. This differs to standards parsing in some subtle ways.
 * You can iterate a URL parameters array directly via `URL.searchParams.params`. This is around
   20% faster than using an iterator.
 * Parameter strings (`;` sepearated key/value pairs) are parsed, and accessible via `URL.parameters`.
 * Domain parsing with [tldts](https://github.com/remusao/tldts) is built in. The `URL.domainInfo` attribute returns output from tldts'
   `parseHost` method.
 * Hostname validation is not done on initial parse. The `isValidHost()` method is provided for
   this purpose.
 * All URLs with a valid authority are given an `origin`, regardless of the protocol scheme. This differs from the [standard](https://url.spec.whatwg.org/#origin) that only does so for a set of known schemes.

## Install

```bash
npm install @ghostery/url-parser
```

## Usage

```javascript
const parsed = new URL('https://www.example.com');
parsed.hostname // == 'www.example.com'
```

## Performance

We benchmark against a list of 250,000 URLs collected from popular sites, as previously used in our
[adblocker benchmark](https://whotracks.me/blog/adblockers_performance_study.html). We compare
two use-cases:
 1. `URL` object creation: `new URL(url)`
 2. Query string parsing: `new URL(url).searchParams.entries()`

We compare to a reference implementation on each platform:
 * Node: `URL` class from the `url` library
 * Firefox: `window.URL`
 * Chrome: `window.URL`
 * Safari: `window.URL`

| Environment | Use case | Reference: urls/s | Ghostery parser: urls/s | Speedup |
| --- | --- | --: | --: | --- |
| Node 11 | `new URL()` | `149,514` | `1,577,711` | _10.5x faster_
| Node 11 | `searchParams` | `140,544` | `198,340` | _1.4x faster_
| Firefox 69 | `new URL()` | `268,066` | `1,043,877` | _3.9x faster_
| Firefox 69 | `searchParams` | `119,207` | `354,793` | _3.0x faster_
| Chrome 75 | `new URL()` | `366,294` | `1,721,903` | _4.7x faster_
| Chrome 75 | `searchParams` | `144,309` | `283,956` | _2.0x faster_
| Safari 12 |  `new URL()` | `656,930` | `1,525,078` | _2.3x faster_
| Safari 12 | `searchParams` | `264,481` | `437,738` | _1.7x faster_

All benchmarks were run on a Mid 2015 Macbook Pro, 2.5 GHz Intel Core i7, 16GB.

## License

[Mozilla Public License 2.0](./LICENSE)

---
_Source: https://npm.io/package/@ghostery/url-parser · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._