Security News
Introducing the Socket Python SDK
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
native-url
Advanced tools
A lightweight implementation of Node's url interface atop the URL API. Use it instead of the url
module to reduce your bundle size by around 7.5 kB.
Weighs 1.6 kB gzipped, works in Node.js 7+ and all modern browsers:
Older browsers can be easily polyfilled without new browsers loading the code.
npm i native-url
const url = require('native-url');
url.parse('https://example.com').host; // example.com
url.parse('/?a=b', true).query; // { a: 'b' }
When you use the url
module, webpack bundles node-url
for the browser. You can alias webpack to use native-url
instead, saving around 7.5kB:
// webpack.config.js
module.exports = {
// ...
resolve: {
alias: {
url: 'native-url',
},
},
};
The result is functionally equivalent in Node 7+ and all modern browsers.
Rollup does not bundle shims for Node.js modules like url
by default, but we can add url
support via native-url
using aliases:
// rollup.config.js
import resolve from 'rollup-plugin-node-resolve';
import alias from '@rollup/plugin-alias';
module.exports = {
// ...
plugins: [
resolve(),
alias({
entries: {
url: 'native-url',
},
}),
],
};
With this in place, import url from 'url'
will use native-url
and keep your bundle small.
Refer Node's legacy url documentation for detailed API documentation.
url.parse(urlStr, [parseQueryString], [slashesDenoteHost])
Parses a URL string and returns a URL object representation:
url.parse('https://example.com');
// {
// href: 'http://example.com/',
// protocol: 'http:',
// slashes: true,
// host: 'example.com',
// hostname: 'example.com',
// query: {},
// search: null,
// pathname: '/',
// path: '/'
// }
url.parse('/foo?a=b', true).query.a; // "b"
url.format(urlObj)
Given a parsed URL object, returns its corresponding URL string representation:
url.format({ protocol: 'https', host: 'example.com' });
// "https://example.com"
url.resolve(from, to)
Resolves a target URL based on the provided base URL:
url.resolve('/a/b', 'c');
// "/a/b/c"
url.resolve('/a/b', '/c#d');
// "/c#d"
native-url
relies on the DOM URL API to work. For older browsers that don't support the URL
API, a polyfill is available.
Conveniently, a polyfill is never needed for browsers that support ES Modules, so we can use <script nomodule>
to conditionally load it for older browsers:
<script nomodule src="/path/to/url-polyfill.js"></script>
FAQs
Brings the node url api layer to whatwg-url class
The npm package native-url receives a total of 789,166 weekly downloads. As such, native-url popularity was classified as popular.
We found that native-url demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.
Security News
A new Rust RFC proposes "Trusted Publishing" for Crates.io, introducing short-lived access tokens via OIDC to improve security and reduce risks associated with long-lived API tokens.