输出

3. 输出

3.1 不要显示JS堆栈CssSyntaxError

PostCSS运行器不得显示CSS语法错误的堆栈跟踪,因为不熟悉JavaScript的开发人员可以使用该运行器。相反,优雅地处理这样的错误:

processor.process(opts).catch(function (error) { if ( error.name === 'CssSyntaxError' ) { process.stderr.write(error.message + error.showSourceCode() } else { throw error; } }

3.2 显示result.warnings()

PostCSS跑步者必须输出以下警告result.warnings()

result.warnings().forEach(function (warn) { process.stderr.write(warn.toString() }

另请参阅postcss-log-warningspostcss-messages插件。

3.3 允许用户将源映射写入不同的文件

PostCSS默认情况下会在生成的文件中内联源映射; 但是,PostCSS运行者必须提供将源地图保存在不同文件中的选项:

if ( result.map ) { fs.writeFile(opts.to + '.map', result.map.toString() }