Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

fetch-link

Package Overview
Dependencies
Maintainers
1
Versions
4
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

fetch-link

Fetch related content by following Link headers

  • 1.3.0
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
4
increased by300%
Maintainers
1
Weekly downloads
 
Created
Source

#fetch-link

Extension of fetch to recursively fetch resources using the Link header

API

next, prev, first, last

Methods that will fetch the given linked resource if specified in the 'Link' header. Each function accepts two parameters (res, options) and returns a promise for a Response

  • res Either a Response instance or the value of the Link header extracted from a Response object
  • options object to pass in to the fetch request for th elinked resource

all(url, options)

Recursively fetches all linked resources, beginning with the given url. Returns a promise for an array of Response instances

  • url The url to fetch
  • options Object to configure requests and recursive behaviour. Accepts the following properties (all optional)
    • fetch An object that will be passed as the optiosn to every fetch request sent. Can also be afunction, expecting url as the first parameter, and returning an optiosn object, so that each fetch can be configured independently e.g. send a different eTag with each fetch
    • direction 'next' or 'prev', indicating which direction to follow links in (default is to follow both 'next' and 'prev')
    • limit maximum number of links to follow. Note that the behaviour when specifying limit and not specifying direction is not guaranteed to produce the same results every time because e.g. a single slow response in the 'next' direction can result in requests being weighted towards the 'prev' direction
    • failGracefully By default a single failed response will cause all() to reject with the error thrown. If failGracefully is true then it will continue to follow links in the opposite direction to the one which has errored and eventually resolve with a promise for an array of responses with the error returned in the first/last place. This only applies to javascript errors thrown by fetch; http errors (503 etc) count as succesful responses and if the response specifies a Link header then it will be followed as normal.

setFetchImplementation(func)

Use a custom implementation of fetch

Keywords

FAQs

Package last updated on 09 Feb 2017

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc