|
|
|
|
<!doctype html>
|
|
|
|
|
<html>
|
|
|
|
|
<title>cache</title>
|
|
|
|
|
<meta http-equiv="content-type" value="text/html;utf-8">
|
|
|
|
|
<link rel="stylesheet" type="text/css" href="../style.css">
|
|
|
|
|
|
|
|
|
|
<body>
|
|
|
|
|
<div id="wrapper">
|
|
|
|
|
<h1><a href="../doc/cache.html">cache</a></h1> <p>Manipulates packages cache</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="SYNOPSIS">SYNOPSIS</h2>
|
|
|
|
|
|
|
|
|
|
<pre><code>npm cache add <tarball file>
|
|
|
|
|
npm cache add <folder>
|
|
|
|
|
npm cache add <tarball url>
|
|
|
|
|
npm cache add <name>@<version>
|
|
|
|
|
|
|
|
|
|
npm cache ls [<path>]
|
|
|
|
|
|
|
|
|
|
npm cache clean [<path>]</code></pre>
|
|
|
|
|
|
|
|
|
|
<h2 id="DESCRIPTION">DESCRIPTION</h2>
|
|
|
|
|
|
|
|
|
|
<p>Used to add, list, or clear the npm cache folder.</p>
|
|
|
|
|
|
|
|
|
|
<ul><li><p>add:
|
|
|
|
|
Add the specified package to the local cache. This command is primarily
|
|
|
|
|
intended to be used internally by npm, but it can provide a way to
|
|
|
|
|
add data to the local installation cache explicitly.</p></li><li><p>ls:
|
|
|
|
|
Show the data in the cache. Argument is a path to show in the cache
|
|
|
|
|
folder. Works a bit like the <code>find</code> program, but limited by the
|
|
|
|
|
<code>depth</code> config.</p></li><li><p>clean:
|
|
|
|
|
Delete data out of the cache folder. If an argument is provided, then
|
|
|
|
|
it specifies a subpath to delete. If no argument is provided, then
|
|
|
|
|
the entire cache is cleared.</p></li></ul>
|
|
|
|
|
|
|
|
|
|
<h2 id="DETAILS">DETAILS</h2>
|
|
|
|
|
|
|
|
|
|
<p>npm stores cache data in <code>$HOME/.npm</code>. For each package that is added
|
|
|
|
|
to the cache, three pieces of information are stored in
|
|
|
|
|
<code>{cache}/{name}/{version}</code>:</p>
|
|
|
|
|
|
|
|
|
|
<ul><li>.../package/:
|
|
|
|
|
A folder containing the package contents as they appear in the tarball.</li><li>.../package.json:
|
|
|
|
|
The package.json file, as npm sees it, with overlays applied and a _id attribute.</li><li>.../package.tgz:
|
|
|
|
|
The tarball for that version.</li></ul>
|
|
|
|
|
|
|
|
|
|
<p>Additionally, whenever a registry request is made, a <code>.cache.json</code> file
|
|
|
|
|
is placed at the corresponding URI, to store the ETag and the requested
|
|
|
|
|
data.</p>
|
|
|
|
|
|
|
|
|
|
<p>Commands that make non-essential registry requests (such as <code>search</code> and
|
|
|
|
|
<code>view</code>, or the completion scripts) generally specify a minimum timeout.
|
|
|
|
|
If the <code>.cache.json</code> file is younger than the specified timeout, then
|
|
|
|
|
they do not make an HTTP request to the registry.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="CONFIGURATION">CONFIGURATION</h2>
|
|
|
|
|
|
|
|
|
|
<h3 id="cache">cache</h3>
|
|
|
|
|
|
|
|
|
|
<p>Default: <code>$HOME/.npm</code> on Posix, or <code>$HOME/npm-cache</code> on Windows.</p>
|
|
|
|
|
|
|
|
|
|
<p>The root cache folder.</p>
|
|
|
|
|
|
|
|
|
|
<h2 id="SEE-ALSO">SEE ALSO</h2>
|
|
|
|
|
|
|
|
|
|
<ul><li><a href="../doc/folders.html">folders(1)</a></li><li><a href="../doc/config.html">config(1)</a></li><li><a href="../doc/install.html">install(1)</a></li><li><a href="../doc/publish.html">publish(1)</a></li><li><a href="../doc/pack.html">pack(1)</a></li></ul>
|
|
|
|
|
</div>
|
|
|
|
|
<p id="footer">cache — npm@1.1.44</p>
|
|
|
|
|
<script>
|
|
|
|
|
;(function () {
|
|
|
|
|
var wrapper = document.getElementById("wrapper")
|
|
|
|
|
var els = Array.prototype.slice.call(wrapper.getElementsByTagName("*"), 0)
|
|
|
|
|
.filter(function (el) {
|
|
|
|
|
return el.parentNode === wrapper
|
|
|
|
|
&& el.tagName.match(/H[1-6]/)
|
|
|
|
|
&& el.id
|
|
|
|
|
})
|
|
|
|
|
var l = 2
|
|
|
|
|
, toc = document.createElement("ul")
|
|
|
|
|
toc.innerHTML = els.map(function (el) {
|
|
|
|
|
var i = el.tagName.charAt(1)
|
|
|
|
|
, out = ""
|
|
|
|
|
while (i > l) {
|
|
|
|
|
out += "<ul>"
|
|
|
|
|
l ++
|
|
|
|
|
}
|
|
|
|
|
while (i < l) {
|
|
|
|
|
out += "</ul>"
|
|
|
|
|
l --
|
|
|
|
|
}
|
|
|
|
|
out += "<li><a href='#" + el.id + "'>" +
|
|
|
|
|
( el.innerText || el.text || el.innerHTML)
|
|
|
|
|
+ "</a>"
|
|
|
|
|
return out
|
|
|
|
|
}).join("\n")
|
|
|
|
|
toc.id = "toc"
|
|
|
|
|
document.body.appendChild(toc)
|
|
|
|
|
})()
|
|
|
|
|
</script>
|
|
|
|
|
</body></html>
|
