@ampproject/toolbox-runtime-fetch
v2.10.1
Published
Download the AMP runtime
Downloads
510
Readme
AMP Download Runtime
The AMP Download Runtime tool fetches a complete, compiled AMP runtime and saves it to disk. You can use this tool to fetch AMP Project releases from cdn.ampproject.org
or direct it to download an AMP runtime hosted elsewhere.
Special handling is included for amp-geo. For hosting environments that dynamically modify amp-geo.js
when served, this tool restores the content to its unpatched state.
Installation
Install via:
npm install @ampproject/toolbox-runtime-fetch --save
Options
dest
(requiredstring
): Specify the destination directory where the AMP runtime should be saved. The runtime will be downloaded to an RTV-specific path underdest
.clear
(optionalboolean
): Remove all contents from the destination directory before saving the AMP runtime. Defaults totrue
.rtv
(optionalstring
): Specify the runtime version to download. Defaults to the latest production version available.ampUrlPrefix
(optionalstring
): Specify the URL where the AMP runtime is hosted. Defaults tohttps://cdn.ampproject.org
.
Note: When downloading AMP Project releases, the runtime version (rtv
) is obtained by prepending 01
(production) or 00
(canary) to the version. For example, the rtv
for production release 2003101714470
is 012003101714470
.
Usage
Basic usage:
const downloadRuntime = require('@ampproject/toolbox-runtime-fetch');
let result;
// Download the latest AMP Project release to /tmp/amp/rtv/<rtv>,
// where <rtv> is detected automatically
result = await downloadRuntime.getRuntime({
dest: '/tmp/amp' // Windows filesystem paths are also supported
});
// Download a specific version of the AMP runtime from Bing
result = await downloadRuntime.getRuntime({
dest: '/tmp/amp' // Windows filesystem paths are also supported
rtv: '011912201827130',
ampPrefixUrl: 'https://www.bing-amp.com'
});
/**
* The object returned from getRuntime() includes the success or failure status,
* as well as data about the AMP runtime that was downloaded:
* {
* status: {boolean} Overall AMP runtime download status
* error: {string} Error message on failure
* count: {number} Number of files in the AMP runtime
* url: {string} URL to AMP runtime
* dest: {string} Path to directory where AMP runtime was downloaded
* rtv: {string} Runtime version of AMP runtime
* }
*/