gofor

Each Gofor instance exposes a fetch method: a lean, isomorphic fetch decorator that deep reverse merges default options.

Options you pass through in for each request will take precedence, but will supplemented with the defaults.

• Installation
• Usage
  • Using the Gofor class
  • "Out of the box" usability with instances
  • Configuring an instance
    • Setting Headers
    • Delayed configuration
• FAQ
  • How do I migrate from version 2 to version 3?

Installation

npm i gofor

Usage

Using the Gofor class

1const Gofor = require('gofor');
2const myGofor = new Gofor({headers: {'X-Custom-Header': 'Custom-Value'}});
3
4myGofor.fetch('/page')
5    .then(...)
6    .catch(...);

"Out of the box" usability with instances

You can opt to import the gofor property to get a working instance with the default environment Headers:

1const { gofor } = require('gofor');
2
3gofor('/page').then(...); // This is the fetch

Each call to Gofor.gofor generates a new instance:

1const gofor1 = require('gofor').gofor;
2const gofor2 = require('gofor').gofor;
3
4gofor1 === gofor2 // false

Configuring an instance

1const { gofor } = require('gofor');
2const defaultHeaders = new Headers();
3
4defaultHeaders.append('X-Requested-With', 'XMLHttpRequest');
5defaultHeaders.append('Content-Type', 'application/json; charset=utf-8');
6defaultHeaders.append('Accept', 'application/json');
7
8gofor.config({
9    credentials: 'same-origin',
10    headers: defaultHeaders
11});
12
13// Use only defaults
14gofor('https://www.website.com').then(...);
15
16// Add/Apply other options
17gofor('/page', {
18    headers: {
19        'X-Custom-Header': 'Custom-Value'
20    }
21}).then(...);

Setting Headers

Gofor supports setting headers either as an object literal or as a Headers instance Default header keys will be run over if matched by passed in header keys. Other keys will be merged. This is made by design.

Example

1// Configure using the "Headers" constructor
2
3gofor.config({
4    credentials: 'same-origin',
5    headers: new Headers({
6        'Content-Type': 'application/json; charset=utf-8',
7        'X-Custom-Header': 'Custom-Value'
8    })
9});
10
11// Or, using an object literal
12
13gofor.config({
14    credentials: 'same-origin',
15    headers: {
16        'Content-Type': 'application/json; charset=utf-8',
17        'X-Custom-Header': 'Custom-Value'
18    }
19});
20
21gofor('/page', {
22    headers: new Headers({
23        'Content-Type': 'text/plain',
24    })
25});

Final headers will be:

1    'Content-Type': 'text/plain',
2    'X-Custom-Header': 'Custom-Value'

Delayed configuration

The function will be called once on first use, and its result will be memoised. useful for cases where you need to pull information from the document and don't want to create a race condition.

1const { gofor } = require('gofor');
2
3gofor.config(() => ({
4    credentials: 'same-origin',
5    headers: {
6        'X-Requested-With': 'XMLHttpRequest',
7        'Content-Type': 'application/json; charset=utf-8',
8        'Accept': 'application/json',
9        'X-Custom-Secret': document.getElementById('secret').value,
10    },
11}));

FAQ

How do I migrate from version 2 to version 3?

The two breaking changes in version 3 are:

• Deprecation of the server entry (gofor/server) in favor of a truly isomorphic solution.
• Deprecation of the dist folder.