CustomFunction<sync>
Параметры типа
-
sync extends "sync" | "async"
Объявление типа
-
- (args: Значение[]): PromiseOr<Значение, sync>
-
Обратный вызов, реализующий пользовательскую функцию Sass. Может быть передан в functions.
constresult = sass.compile('style.scss', {
functions: {
"sum($arg1, $arg2)": (args) => {
constarg1 = args[0].assertNumber('arg1');
constvalue1 = arg1.value;
constvalue2 = args[1].assertNumber('arg2')
.convertValueToMatch(arg1, 'arg2', 'arg1');
returnnewsass.SassNumber(value1 + value2).coerceToMatch(arg1);
}
}
});Исключения
any - Данная функция может выбросить ошибку, которую компилятор Sass будет обрабатывать как ошибку выполнения функции. Если у объекта исключения есть свойство
message, оно будет использовано в качестве сообщения об ошибке; в противном случае будет использовано свойствоtoString()объекта исключения. Это означает, что пользовательские функции могут безопасно выбрасывать простые строки.Параметры
-
args: Значение[]
Массив аргументов, переданных вызывающей функцией. Если функция принимает произвольное количество аргументов, последний элемент будет SassArgumentList.
Возвращает PromiseOr<Значение, sync>
Результат работы функции. Он может быть в форме
Promise, но если это так, то функция может быть передана только в compileAsync и compileStringAsync, а не в compile или compileString. -
© 2006–2025 the Sass team, and numerous contributors
Licensed under the MIT License.
https://sass-lang.com/documentation/js-api/types/CustomFunction
Синхронная
CustomFunction<'sync'>должна возвращать результат синхронно, но при этом её можно передать в compile и compileString помимо compileAsync и compileStringAsync.Асинхронная
CustomFunction<'async'>может возвращать результат синхронно или асинхронно, но её можно использовать только с compileAsync и compileStringAsync.