Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details

All Projects → ospfranco → Link Preview Js

ospfranco / Link Preview Js

Licence: mit

Parse and/or extract web links meta information: title, description, images, videos, etc. [via OpenGraph], runs on mobiles and node.

Programming Languages

184084 projects - #8 most used programming language

32286 projects

Labels

nodejs react-native http chrome firefox parsing extract cors safari link js-library

Projects that are alternatives of or similar to Link Preview Js

Browser extension that enhances GitHub code review and exploration. You can download Octotree for your browser from our website.

Stars: ✭ 21,726 (+8952.5%)

Mutual labels: chrome, firefox, safari

Various Automator and AppleScript workflow and scripts for simplifying life

Stars: ✭ 68 (-71.67%)

Mutual labels: chrome, firefox, safari

Your browser, your page, your scripts!

Stars: ✭ 474 (+97.5%)

Mutual labels: chrome, firefox, safari

The browser extension vault (Chrome, Firefox, Opera, Edge, Safari, & more).

Stars: ✭ 3,305 (+1277.08%)

Mutual labels: chrome, firefox, safari

Extension Create

Create modern cross-browser extensions with no build configuration.

Stars: ✭ 167 (-30.42%)

Mutual labels: chrome, firefox, safari

Arduino Create Agent

The Arduino Create Agent

Stars: ✭ 298 (+24.17%)

Mutual labels: chrome, firefox, safari

uBlock: a fast, lightweight, and lean blocker for Chrome, Firefox, and Safari.

Stars: ✭ 8,075 (+3264.58%)

Mutual labels: chrome, firefox, safari

Pure Clojure Webdriver protocol implementation

Stars: ✭ 599 (+149.58%)

Mutual labels: chrome, firefox, safari

Tua Body Scroll Lock

🔐 Body scroll locking that just works with everything

Stars: ✭ 236 (-1.67%)

Mutual labels: chrome, firefox, safari

Known Css Properties

List of standard and browser specific CSS properties.

Stars: ✭ 89 (-62.92%)

Mutual labels: chrome, firefox, safari

The Freedom to Open URLs in Third-Party Browsers on iOS with Custom UIActivity Subclasses.

Stars: ✭ 85 (-64.58%)

Mutual labels: chrome, firefox, safari

💭 Inspiration

Stars: ✭ 3,630 (+1412.5%)

Mutual labels: chrome, firefox, safari

Kule Lazy4 / CSS Framework

Stars: ✭ 147 (-38.75%)

Mutual labels: chrome, firefox, safari

C# Framework to automate tests using Selenium WebDriver

Stars: ✭ 234 (-2.5%)

Mutual labels: chrome, firefox, safari

A collection of tools for forensic analysis

Stars: ✭ 204 (-15%)

Mutual labels: chrome, firefox

Preact Devtools

Browser extension for inspection Preact applications

Stars: ✭ 204 (-15%)

Mutual labels: chrome, firefox

Docker Robot Framework

Robot Framework in Docker Alpine

Stars: ✭ 212 (-11.67%)

Mutual labels: chrome, firefox

Powerfull download accelerator and video downloader

Stars: ✭ 3,226 (+1244.17%)

Mutual labels: chrome, firefox

Async WebDriver implementation for asyncio and asyncio-compatible frameworks

Stars: ✭ 209 (-12.92%)

Mutual labels: chrome, firefox

Dockerized Selenium and Python with support for Chrome, Firefox and PhantomJS

Stars: ✭ 237 (-1.25%)

Mutual labels: chrome, firefox

View All Similar Projects ➔

This package is no longer maintained, I had fun creating it and improving it but not interested in maintaining it and taking care of issues, if you need it fork it, release a copy, etc

Link Preview JS

Allows you to extract information from a HTTP url/link (or parse a HTML document) and retrieve meta information such as title, description, images, videos, etc. Written in Typescript. The information is extracted directly from the HTML from facebook OpenGraph protocol.

GOTCHAs

Browsers do not allow you to do requests to a different domain, you cannot request a different domain from your web app. If do not know how same-origin-policy works, here is a good intro, therefore this library works on node (back-end environments) and certain mobile run-times (cordova or react-native).
www.google.com does not return a required meta data, test with another domain.
If you are running on a mobile, please think about what you are doing, this library does not do magic, it simply fetches the website and parses its html, therefore it acts as if the user would visit the page: YouTube re-directs you to the mobile site and Instagram (and other social sites) might redirect you to a sign up page, you can try to change the user-agent header (try with "google-bot"), but there is nothing wrong with this library, work around these issues yourself.

Created by Oscar Franco

Follow me on Twitter or please consider sponsoring to support the development.

How to use

Install

yarn add link-preview-js
-- OR --
npm install link-preview-js

API

getLinkPreview: you have to pass a string, doesn't matter if it is just a URL or a piece of text that contains a URL, the library will take care of parsing it and returning the info of first valid HTTP(S) URL info it finds. (URL parsing is done via: https://gist.github.com/dperini/729294).

getPreviewFromContent: useful for passing a pre-fetched Response object from an existing async/etc. call. Refer to example below for required object values.

import { getLinkPreview, getPreviewFromContent } from 'link-preview-js';

// pass the link directly
getLinkPreview('https://www.youtube.com/watch?v=MejbOFk7H6c')
  .then((data) => console.debug(data));

////////////////////////// OR //////////////////////////

// pass a chunk of text
getLinkPreview('This is a text supposed to be parsed and the first link displayed https://www.youtube.com/watch?v=MejbOFk7H6c')
  .then((data) => console.debug(data));


////////////////////////// OR //////////////////////////

// pass a pre-fetched response object
// The passed response object should include, at minimum:
// {
//   data: '<!DOCTYPE...><html>...',     // response content
//   headers: {
//     ...
//     // should include content-type
//     content-type: "text/html; charset=ISO-8859-1",
//     ...
//   },
//   url: 'https://domain.com/'          // resolved url
// }
yourAjaxCall(url, (response) => {
  getPreviewFromContent(response)
    .then((data) => console.debug(data));
  })

Options

Additionally you can pass an options object which should add more functionality to the parsing of the link

Property Name	Result
imagesPropertyType (optional) (ex: 'og')	Fetches images only with the specified property, `meta[property='${imagesPropertyType}:image']`
headers (optional) (ex: { 'user-agent': 'googlebot', 'Accept-Language': 'en-US' })	Add request headers to fetch call

getLinkPreview("https://www.youtube.com/watch?v=MejbOFk7H6c", {
  imagesPropertyType: "og", // fetches only open-graph images
  headers: {
    "user-agent": "googlebot" // fetches with googlebot crawler user agent
    "Accept-Language": "fr-CA", // fetches site for French language
    // ...other optional HTTP request headers
  }
}).then(data => console.debug(data));

Response

Returns a Promise that resolves with an object describing the provided link. The info object returned varies depending on the content type (MIME type) returned in the HTTP response (see below for variations of response). Rejects with an error if response can not be parsed or if there was no URL in the text provided.

Text/HTML URL

{
  url: "https://www.youtube.com/watch?v=MejbOFk7H6c",
  title: "OK Go - Needing/Getting - Official Video - YouTube",
  siteName: "YouTube",
  description: "Buy the video on iTunes: https://itunes.apple.com/us/album/needing-getting-bundle-ep/id508124847 See more about the guitars at: http://www.gretschguitars.com...",
  images: ["https://i.ytimg.com/vi/MejbOFk7H6c/maxresdefault.jpg"],
  mediaType: "video.other",
  contentType: "text/html; charset=utf-8",
  videos: [],
  favicons:["https://www.youtube.com/yts/img/favicon_32-vflOogEID.png","https://www.youtube.com/yts/img/favicon_48-vflVjB_Qk.png","https://www.youtube.com/yts/img/favicon_96-vflW9Ec0w.png","https://www.youtube.com/yts/img/favicon_144-vfliLAfaB.png","https://s.ytimg.com/yts/img/favicon-vfl8qSV2F.ico"]
}

Image URL

{
  url: "https://media.npr.org/assets/img/2018/04/27/gettyimages-656523922nunes-4bb9a194ab2986834622983bb2f8fe57728a9e5f-s1100-c15.jpg",
  mediaType: "image",
  contentType: "image/jpeg",
  favicons: [ "https://media.npr.org/favicon.ico" ]
}

Audio URL

{
  url: "https://ondemand.npr.org/anon.npr-mp3/npr/atc/2007/12/20071231_atc_13.mp3",
  mediaType: "audio",
  contentType: "audio/mpeg",
  favicons: [ "https://ondemand.npr.org/favicon.ico" ]
}

Video URL

{
  url: "https://www.w3schools.com/html/mov_bbb.mp4",
  mediaType: "video",
  contentType: "video/mp4",
  favicons: [ "https://www.w3schools.com/favicon.ico" ]
}

Application URL

{
  url: "https://assets.curtmfg.com/masterlibrary/56282/installsheet/CME_56282_INS.pdf",
  mediaType: "application",
  contentType: "application/pdf",
  favicons: [ "https://assets.curtmfg.com/favicon.ico" ]
}

License

MIT license

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].

Stars: ✭ 240

Visit Git Page 🔗Visit User Page 🔗Visit Issues Page (0) 🔗