https://github.com/jakejarvis/get-canonical-url
🔗 Determines the current page's canonical URL and optionally normalizes it for consistency.
https://github.com/jakejarvis/get-canonical-url
address browser canonical dom front-end javascript link normalize npm uri url
Last synced: 7 months ago
JSON representation
🔗 Determines the current page's canonical URL and optionally normalizes it for consistency.
- Host: GitHub
- URL: https://github.com/jakejarvis/get-canonical-url
- Owner: jakejarvis
- License: mit
- Created: 2021-09-29T15:39:16.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-02-28T04:02:35.000Z (over 3 years ago)
- Last Synced: 2025-03-30T21:33:09.487Z (over 1 year ago)
- Topics: address, browser, canonical, dom, front-end, javascript, link, normalize, npm, uri, url
- Language: TypeScript
- Homepage:
- Size: 368 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🔗 get-canonical-url
[](https://github.com/jakejarvis/get-canonical-url/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/get-canonical-url)
Determines the current page's canonical URL and optionally normalizes it via [normalize-url](https://github.com/sindresorhus/normalize-url) for consistency.
## Install
```sh
npm install get-canonical-url
# or...
yarn add get-canonical-url
```
Or pull directly from [unpkg](https://unpkg.com/browse/get-canonical-url/) in-browser:
```html
```
## Usage
### With ``
```html
```
```js
import canonicalUrl from "get-canonical-url";
canonicalUrl();
//=> 'https://www.example.com/this/doesnt/exist.aspx?no=really&it=doesnt#gocheck'
canonicalUrl({
normalize: true,
normalizeOptions: {
stripProtocol: true,
stripWWW: true,
stripHash: true
}
})
//=> 'example.com/this/doesnt/exist.aspx?it=doesnt&no=really'
```
### Without ``
```js
import canonicalUrl from "get-canonical-url";
canonicalUrl({
guess: true,
normalize: true
});
//=> Determined via the individual user's window.location.href or other similar browser hints. Normalizing is recommended.
```
## API
### canonicalUrl(options?)
#### options
Type: `object`
##### normalize
Type: `boolean`\
Default: `false`
Clean-up and normalize the determined canonical URL.
##### normalizeOptions
Type: [`NormalizeOptions`](https://github.com/sindresorhus/normalize-url/blob/main/index.d.ts)\
Default:
```js
{
stripWWW: false,
stripHash: true,
removeQueryParameters: true,
removeTrailingSlash: false
}
```
Options passed directly to [`normalize-url`](https://github.com/sindresorhus/normalize-url#options).
Requires `options.normalize = true`.
##### guess
Type: `boolean`\
Default: `false`
Make an educated guess using other clues if canonical isn't explicitly set in the page's ``.
## License
MIT