wishthis/node_modules/resolve-url/readme.md
2022-01-21 09:28:41 +01:00

83 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Overview
========
[![browser support](https://ci.testling.com/lydell/resolve-url.png)](https://ci.testling.com/lydell/resolve-url)
Like Node.js [`path.resolve`]/[`url.resolve`] for the browser.
```js
var resolveUrl = require("resolve-url")
window.location
// https://example.com/articles/resolving-urls/edit
resolveUrl("remove")
// https://example.com/articles/resolving-urls/remove
resolveUrl("/static/scripts/app.js")
// https://example.com/static/scripts/app.js
// Imagine /static/scripts/app.js contains `//# sourceMappingURL=../source-maps/app.js.map`
resolveUrl("/static/scripts/app.js", "../source-maps/app.js.map")
// https://example.com/static/source-maps/app.js.map
resolveUrl("/static/scripts/app.js", "../source-maps/app.js.map", "../coffee/app.coffee")
// https://example.com/static/coffee/app.coffee
resolveUrl("//cdn.example.com/jquery.js")
// https://cdn.example.com/jquery.js
resolveUrl("http://foo.org/")
// http://foo.org/
```
Installation
============
- `npm install resolve-url`
- `bower install resolve-url`
- `component install lydell/resolve-url`
Works with CommonJS, AMD and browser globals, through UMD.
Usage
=====
### `resolveUrl(...urls)` ###
Pass one or more urls. Resolves the last one to an absolute url, using the
previous ones and `window.location`.
Its like starting out on `window.location`, and then clicking links with the
urls as `href` attributes in order, from left to right.
Unlike Node.js [`path.resolve`], this function always goes through all of the
arguments, from left to right. `path.resolve` goes from right to left and only
in the worst case goes through them all. Should that matter.
Actually, the function is _really_ like clicking a lot of links in series: An
actual `<a>` gets its `href` attribute set for each url! This means that the
url resolution of the browser is used, which makes this module really
light-weight.
Also note that this functions deals with urls, not paths, so in that respect it
has more in common with Node.js [`url.resolve`]. But the arguments are more
like [`path.resolve`].
[`path.resolve`]: http://nodejs.org/api/path.html#path_path_resolve_from_to
[`url.resolve`]: http://nodejs.org/api/url.html#url_url_resolve_from_to
Tests
=====
Run `npm test`, which lints the code and then gives you a link to open in a
browser of choice (using `testling`).
License
=======
[The X11 (“MIT”) License](LICENSE).