uri-metadata

uri-metadata is a TypeScript library for extracting metadata information, including Twitter and Open Graph properties, from any HTTP/HTTPS URL. It is specifically designed to be useful in development of Chrome extensions.

Highlights

• Passing in a callback

Installation

npm install uri-metadata --save

Usage

Fetch metadata using the provided example below, which returns a Promise:

1import metadata from "uri-metadata";
2
3try {
4  const response = await metadata.get("https://awwwards.com");
5  console.log("Metadata: ", response);
6} catch (err) {
7  console.log("An error occurred: ", err);
8}

Alternatively, you can pass a callback function:

1import metadata from "uri-metadata";
2
3metadata.get("https://awwwards.com", (data, err) => {
4  console.log(err ? err : data);
5});

The response is an object containing the URL metadata grouped by type:

1{
2  meta: {
3    'theme-color': '#3ea094',
4    referrer: 'origin-when-cross-origin',
5    keywords: 'Website Awards, Web Design Inspiration, Webdesign Trends',
6    ...
7  },
8  og: {
9    type: 'website',
10    site_name: 'Awwwards',
11    ...
12  },
13  twitter: {
14    ...
15  }
16}

Options

You can pass true or false as a third argument to group or ungroup metatags (defaults to true). For example:

1response = await metadata.get("https://www.awwwards.com", false);

This returns:

1{
2  'og:type': 'website',
3  'theme-color': '#3ea094',
4  'og:site_name': 'Awwwards',
5  referrer: 'origin-when-cross-origin',
6  keywords: 'Website Awards, Web Design Inspiration, Webdesign Trends',
7  ...
8}

Contributing

1. Fork the repository and create your feature branch: git checkout -b my-update
2. Commit your changes: git commit -am 'Updated some parts'
3. Push to the branch: git push origin my-update
4. Submit a pull request