41 lines
2.8 KiB
Markdown
41 lines
2.8 KiB
Markdown
# @jridgewell/resolve-uri
|
|
|
|
> Resolve a URI relative to an optional base URI
|
|
|
|
Resolve any combination of absolute URIs, protocol-realtive URIs, absolute paths, or relative paths.
|
|
|
|
## Installation
|
|
|
|
```sh
|
|
npm install @jridgewell/resolve-uri
|
|
```
|
|
|
|
## Usage
|
|
|
|
```typescript
|
|
function resolve(input: string, base?: string): string;
|
|
```
|
|
|
|
```js
|
|
import resolve from '@jridgewell/resolve-uri';
|
|
|
|
resolve('foo', 'https://example.com'); // => 'https://example.com/foo'
|
|
```
|
|
|
|
| Input | Base | Resolution | Explanation |
|
|
|-----------------------|-------------------------|--------------------------------|--------------------------------------------------------------|
|
|
| `https://example.com` | _any_ | `https://example.com/` | Input is normalized only |
|
|
| `//example.com` | `https://base.com/` | `https://example.com/` | Input inherits the base's protocol |
|
|
| `//example.com` | _rest_ | `//example.com/` | Input is normalized only |
|
|
| `/example` | `https://base.com/` | `https://base.com/example` | Input inherits the base's origin |
|
|
| `/example` | `//base.com/` | `//base.com/example` | Input inherits the base's host and remains protocol relative |
|
|
| `/example` | _rest_ | `/example` | Input is normalized only |
|
|
| `example` | `https://base.com/dir/` | `https://base.com/dir/example` | Input is joined with the base |
|
|
| `example` | `https://base.com/file` | `https://base.com/example` | Input is joined with the base without its file |
|
|
| `example` | `//base.com/dir/` | `//base.com/dir/example` | Input is joined with the base's last directory |
|
|
| `example` | `//base.com/file` | `//base.com/example` | Input is joined with the base without its file |
|
|
| `example` | `/base/dir/` | `/base/dir/example` | Input is joined with the base's last directory |
|
|
| `example` | `/base/file` | `/base/example` | Input is joined with the base without its file |
|
|
| `example` | `base/dir/` | `base/dir/example` | Input is joined with the base's last directory |
|
|
| `example` | `base/file` | `base/example` | Input is joined with the base without its file |
|