LegacyAsyncFunction

LegacyAsyncFunction: ((this: LegacyPluginThis, done: ((result: LegacyValue) => void)) => void) | ((this: LegacyPluginThis, arg1: LegacyValue, done: LegacyAsyncFunctionDone) => void) | ((this: LegacyPluginThis, arg1: LegacyValue, arg2: LegacyValue, done: LegacyAsyncFunctionDone) => void) | ((this: LegacyPluginThis, arg1: LegacyValue, arg2: LegacyValue, arg3: LegacyValue, done: LegacyAsyncFunctionDone) => void) | ((this: LegacyPluginThis, arg1: LegacyValue, arg2: LegacyValue, arg3: LegacyValue, arg4: LegacyValue, done: LegacyAsyncFunctionDone) => void) | ((this: LegacyPluginThis, arg1: LegacyValue, arg2: LegacyValue, arg3: LegacyValue, arg4: LegacyValue, arg5: LegacyValue, done: LegacyAsyncFunctionDone) => void) | ((this: LegacyPluginThis, arg1: LegacyValue, arg2: LegacyValue, arg3: LegacyValue, arg4: LegacyValue, arg5: LegacyValue, arg6: LegacyValue, done: LegacyAsyncFunctionDone) => void) | ((this: LegacyPluginThis, …args: […LegacyValue[], LegacyAsyncFunctionDone]) => void)

一个实现自定义 Sass 函数的异步回调。这可以传递给 functions，但仅适用于 render.

异步函数必须返回 undefined。它的最后一个参数始终是一个回调，它应该在函数完成运行后，使用函数的结果调用该回调。

如果它抛出一个错误，Sass 将将其视为函数使用该错误消息失败。

sass.render({
  file: 'style.scss',
  functions: {
    "sum($arg1, $arg2)": (arg1, arg2, done) => {
      if (!(arg1 instanceof sass.types.Number)) {
        throw new Error("$arg1: Expected a number");
      } else if (!(arg2 instanceof sass.types.Number)) {
        throw new Error("$arg2: Expected a number");
      }
      done(new sass.types.Number(arg1.getValue() + arg2.getValue()));
    }
  }
}, (result, error) => {
  // ...
});

这将为传递给 functions 的签名中声明的每个参数传递一个参数。如果签名接受任意参数，则它们将作为单个参数列表传递给回调之前的最后一个参数。

已弃用

这仅适用于旧版 render 和 renderSync API。使用 CustomFunction 与 compile、compileString、compileAsync 和 compileStringAsync 代替。