有许多原因使得你需要在CSS代码中系统性的替代URL：将其转换为数据URI、将其指向一个CDN、将其文件名替换为自动生成的文件名，等等。这个工具能够帮你从给定的CSS代码中将URL解析出来，并允许你将其替换为你选择的任意值。替换后的CSS代码与源代码完全相同，除了URL已经根据你的选择进行了替换。

这个库包含诸多工具，能够帮助你操作和更改CSS URL。

CSS URL重写器（Rewriter）

CSS URL重写器使用一个CSS分词器来安全的找到所有的CSS URL，这使得所有的改动都是完全安全的，因为它不依赖于正则表达式从CSS中提取URL。

使用方法
 

1. var URLRewriter = require("cssurl").URLRewriter;   
2.     
3. var rewriter = new URLRewriter(function(url) {   
4.     // automatically append a query string with a unique value to bust caches   
5.     return url + "?v=" + Date.now();   
6. });   
7.     
8. var result = rewriter.rewrite(cssCode);   

当CSS URL重写器遍历CSS代码时，它会调用传入CSSURLRewriter构造器的函数，并传给它找到的每个URL。url变量是指CSS代码中找到的除去了任何引号和前后空格的URL（不包含url()）。之后，你可以检查URL，随心所欲地修改它，以及在你需要使用的地方返回它的值。

限制

CSS URL重写器只会替换被表示为URL标记的URL，也就是说，它必须是以url(foo.css)的形式而非”foo.css”的形式存在，尽管后者在部分CSS里是允许的。

CSS URL重写流（Rewrite Stream）

CSS URL重写流使用流内部的URL重写器，因此你可以很容易将代码取出或置入。

使用方法
 

1. var URLRewriteStream = require("cssurl").URLRewriteStream;   
2.     
3. fs.createReadStream("my.css").pipe(new URLRewriteStream(function(url) {   
4.     // automatically append a query string with a unique value to bust caches   
5.     return url + "?v=" + Date.now();   
6. })).pipe(fs.createWriteStream("my-new.css"));    

CSS URL翻译器（Translator）

CSS URL翻译器是一个工具，能够对不同CSS文件中的相关CSS URL进行翻译。有时候你可能要移动一个CSS文件，比如说从css/sprites/foo.css到css/sprites.css，当你做这件事时，CSS文件中任何相关的URL都不再准确了。CSS URL翻译器，与CSS URL重写器结合使用，通过自动计算出新的路径使得我们可以轻松地进行修改。翻译器也足够聪明，不会翻译任何不相关的URL。

使用方法
 

1. var URLTranslator = require("cssurl").URLTranslator;   
2.     
3. var translator = new URLTranslator();   
4. var result = translator.translate("../../img/foo.png", "css/sprites/foo.css", "css/sprites.css");   
5.     
6. console.log(result);    // "../img/foo.png"  

开发

要运行测试，请克隆以下仓库，然后执行：
 

复制代码代码如下:$ npm i
$ npm test

版权和许可证为BSD3