npmpackage.info

Gathering detailed insights and metrics for whatwg-url

Other packages similar to whatwg-url

@types/whatwg-url

13.0.0

TypeScript definitions for whatwg-url

mongodb-connection-string-url

3.0.1

MongoDB connection strings, based on the WhatWG URL API

whatwg-url-compat

0.6.5

An implementation of the WHATWG URL algorithm

postman-url-encoder

3.0.5

Implementation of the WHATWG URL Standard

Gathering detailed insights and metrics for whatwg-url

whatwg-url

An implementation of the WHATWG URL Standard in JavaScript

14.0.0

371

MIT

JavaScript

69.40 kB

11,340,005,815 4.2

Installations

npm install whatwg-url

Score

99.3

Supply Chain

99.6

Quality

82.2

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

2

Total

142

Closed

36

Merged

104

Issues

Open

6

Total

127

Closed

121

Releases

14.0.0

v14.0.0

Published on 05 Nov 2023

13.0.0

v13.0.0

Published on 28 May 2023

12.0.1

v12.0.1

Published on 08 Mar 2023

12.0.0

v12.0.0

Published on 03 Jan 2023

11.0.0

v11.0.0

Published on 19 Oct 2021

10.0.0

v10.0.0

Published on 06 Oct 2021

View all 48 releases

Contributors

View all 20 contributors

Developer

jsdom

Developer Guide

BETA

Module System

CommonJS

Min. Node Version

>=18

Typescript Support

No

Node Version

21.1.0

NPM Version

10.2.0 Statistics

371 Stars

377 Commits

94 Forks

9 Watching

1 Branches

20 Contributors

Updated on 07 Nov 2024

Bundle Size

254.64 kB

Minified

69.40 kB

Minified + Gzipped

Bundlephobia

Languages

JavaScript (92.04%)

HTML (4.31%)

WebIDL (1.77%)

CSS (1.6%)

Shell (0.28%)

Total Downloads

Cumulative downloads

Total Downloads

11,340,005,815

Last day

-1.9%

15,912,668

Compared to previous day

Last week

4.2%

86,251,809

Compared to previous week

Last month

17.3%

344,171,764

Compared to previous month

Last year

12.9%

3,471,892,020

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

tr46 webidl-conversions

Dev Dependencies

@domenic/eslint-config benchmark c8 domexception esbuild eslint webidl2js

Versions

whatwg-url

whatwg-url is a full implementation of the WHATWG URL Standard. It can be used standalone, but it also exposes a lot of the internal algorithms that are useful for integrating a URL parser into a project like jsdom.

Specification conformance

whatwg-url is currently up to date with the URL spec up to commit eee49fd.

For file: URLs, whose origin is left unspecified, whatwg-url chooses to use a new opaque origin (which serializes to "null").

whatwg-url does not yet implement any encoding handling beyond UTF-8. That is, the encoding override parameter does not exist in our API.

API

The `URL` and `URLSearchParams` classes

The main API is provided by the URL and URLSearchParams exports, which follows the spec's behavior in all ways (including e.g. USVString conversion). Most consumers of this library will want to use these.

Low-level URL Standard API

The following methods are exported for use by places like jsdom that need to implement things like HTMLHyperlinkElementUtils. They mostly operate on or return an "internal URL" or "URL record" type.

URL parser: parseURL(input, { baseURL })
Basic URL parser: basicURLParse(input, { baseURL, url, stateOverride })
URL serializer: serializeURL(urlRecord, excludeFragment)
Host serializer: serializeHost(hostFromURLRecord)
URL path serializer: serializePath(urlRecord)
Serialize an integer: serializeInteger(number)
Origin serializer: serializeURLOrigin(urlRecord)
Set the username: setTheUsername(urlRecord, usernameString)
Set the password: setThePassword(urlRecord, passwordString)
Has an opaque path: hasAnOpaquePath(urlRecord)
Cannot have a username/password/port: cannotHaveAUsernamePasswordPort(urlRecord)
Percent decode bytes: percentDecodeBytes(uint8Array)
Percent decode a string: percentDecodeString(string)

The stateOverride parameter is one of the following strings:

The URL record type has the following API:

scheme
username
password
host
port
path (as an array of strings, or a string)
query
fragment

These properties should be treated with care, as in general changing them will cause the URL record to be in an inconsistent state until the appropriate invocation of basicURLParse is used to fix it up. You can see examples of this in the URL Standard, where there are many step sequences like "4. Set context object’s url’s fragment to the empty string. 5. Basic URL parse input with context object’s url as url and fragment state as state override." In between those two steps, a URL record is in an unusable state.

The return value of "failure" in the spec is represented by null. That is, functions like parseURL and basicURLParse can return either a URL record or null.

`whatwg-url/webidl2js-wrapper` module

This module exports the URL and URLSearchParams interface wrappers API generated by webidl2js.

Development instructions

First, install Node.js. Then, fetch the dependencies of whatwg-url, by running from this directory:

npm install

To run tests:

npm test

To generate a coverage report:

npm run coverage

To build and run the live viewer:

npm run prepare
npm run build-live-viewer

Serve the contents of the live-viewer directory using any web server.

Supporting whatwg-url

The jsdom project (including whatwg-url) is a community-driven project maintained by a team of volunteers. You could support us by:

Getting professional support for whatwg-url as part of a Tidelift subscription. Tidelift helps making open source sustainable for us while giving teams assurances for maintenance, licensing, and security.
Contributing directly to the project.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

10

Security-Policy

Determines if the project has published a security policy.

9

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

2

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

1

Maintained

Determines if the project is "actively maintained".

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

4.2

/10

Last Scanned on 2024-11-18

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to whatwg-url

Other packages similar to whatwg-url

whatwg-url

Installations

Score

Pull Requests

2

142

36

104

Issues

6

127

121

Releases

Contributors

Developer

Developer Guide

CommonJS

>=18

No

21.1.0

10.2.0

Statistics

Bundle Size

254.64 kB

69.40 kB

Languages

Total Downloads

11,340,005,815

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

whatwg-url

Specification conformance

API

The URL and URLSearchParams classes

Low-level URL Standard API

whatwg-url/webidl2js-wrapper module

Development instructions

Supporting whatwg-url

10

10

10

10

9

2

1

0

0

0

0

0

0

4.2

/10

The `URL` and `URLSearchParams` classes

`whatwg-url/webidl2js-wrapper` module