A node package to retrieve fetch local or remote files in base64 encoding.
npm install fetch-base64
A node package to fetch local or remote files in base64 encoding. Useful for inlining assets (images, web fonts, etc.) into HTML or CSS documents.
Disclaimer: I've only used this for images so far, but there is no reason why it shouldn't work for any other kind of files.
If you find a bug please report it here.
``js
const fetch = require('fetch-base64');
fetch.local('/path/to/image.jpg').then((data) => {
// data[0] contains the raw base64-encoded jpg
}).catch((reason) => {});
fetch.remote('http://domain.com/to/image.jpg').then((data) => {
// data[1] contains base64-encoded jpg with MimeType
}).catch((reason) => {});
fecth.auto('/remote/or/local/path/image.gif').then((data) => {
}).catch((reason) => {});
`
npm install --save fetch-base64
All the functions return a Promise which when resolved will return an Array with two Strings (data):
- data[0] will contain the raw base64-encoded file. E.g.: iVBORw0KGgoAAAANSUhEUg...
- will contain the same information as data[0] and the mimeType. Useful if you want to embed the file into an HTMl or CSS document. E.g.: data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...
Fetch local files and return a promise with the file in base64 format.
- ...paths : Single or multiple paths which will be combined using node's path.resolve(). You can pass multiple paths to resolve a relative path to an absolute path. Some examples of valid values for this parameter:'/some/absolute/path/image.jpg'
-
-
Fetch remote file in url and return a promise with the file in base64 format.
User Agent is spoofed to be same as Chrome's to avoid some restrictions, but fetching could still fail for other reasons.
- url : URL where the file resides. Note that node must have access to the given URL.
Resolve url using node's url.resolve(from, to), fetch remote file and return a promise with the file in base64 format.
User Agent is spoofed to be same as Chrome's to avoid some restrictions, but fetching could still fail for other reasons.
- from : The Base URL being resolved against.to
- : The HREF URL being resolved.
See url.resolve() for more information and examples.
Advanced version of the fetch.remote where you can pass an options object containing:
- paths <[string]>: Array with 2 Strings representing from and to (see above).url
- : The url to fetch. If both paths and url are passed, paths takes priority.headers
-
User Agent will still be spoofed to be same as Chrome.
This function will do the best effort to automatically detect the kind of path passed (remote or local) and invoke the correspondent function.
It will use the fetch.isRemote() function to determine if a remote url or a local path has been passed in the first parameter.
- ...mixed : Accepts the same parameters as fetch.local(...paths), fetch.remote(url) or fetch.remote(from, to) - see above. Examples of valid calls:fetch.auto('/base/path/to/html', './img/animation.gif');
-
-
-
Returns true if the passed path () is local. Returns false otherwise.
Returns true if the passed path () is remote. Returns false otherwise.
`js`
const fetch = require('fetch-base64');
`jsbase64 image raw: ${data[0]}
// will fetch image in /Users/bla/src/project/img/logo.jpg
const doFetchLocal = fetch.local('/Users/bla/src/project', './img/logo.jpg');
doFetchLocal.then((data) => {
console.log();Fetch Failed: ${reason}
}, (reason) => {
console.log()`
});
`jsbase64 image with mimeType: ${data[1]}
const doFetchRemote = fetch.remote('https://somedomain.com/image.jpg');
doFetchRemote.then((data) => {
console.log();Fetch Failed: ${reason}
}, (reason) => {
console.log()`
});
`jsbase64 image with mimeType: ${data[1]}
const doFetchRemote2 = fetch.remote('https://somedomain.com', '/image.jpg');
doFetchRemote2.then((data) => {
console.log();Fetch Failed: ${reason}
}, (reason) => {
console.log()`
});
`jsbase64 image with mimeType: ${data[1]}
const doFetchRemote = fetch.remote({ url: 'https://somedomain.com/image.jpg', headers: { 'custom-header': 'foo' } });
doFetchRemote.then((data) => {
console.log();Fetch Failed: ${reason}
}, (reason) => {
console.log()`
});
`jsbase64 image: ${data[0]}
const doFetchAuto = fetch.auto('https://somedomain.com/image.jpg');
doFetchAuto.then((data) => {
console.log();Fetch Failed: ${reason}
}, (reason) => {
console.log()`
});
`jsbase64 image: ${data[0]}
const doFetchAuto2 = fetch.auto('/some/local/', '/path/', './image.jpg');
doFetchAuto2.then((data) => {
console.log();Fetch Failed: ${reason}
}, (reason) => {
console.log()``
});