@error
Quando escreves misturas e funções que recebem argumentos, normalmente queres garantir que estes argumentos têm os tipos e formatos que a tua API espera. Se tiverem, o utilizador precisa ser notificado e a tua mistura ou função precisa parar a execução.
A Sass torna isto fácil com a regra @error
, que é escrita como @error <expression>
. Ela imprime o valor da expressão (normalmente uma sequência de caracteres) juntamente com um vestígio da pilha indicando como a mistura ou função atual foi chamada. Assim que o erro for imprimido, a Sass para a compilação da folha de estilo e diz ao seja qual for o sistema que estiver a executá-la que um erro ocorreu:
O formato exato do erro e vestígio da pilha varia de implementação à implementação, e também pode depender do teu sistema de construção. Isto é como se parece na Sass de Dart quando executado a partir da linha de comando:
Error: "Property top must be either left or right."
╷
3 │ @error "Property #{$property} must be either left or right.";
│ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
╵
example.scss 3:5 reflexive-position()
example.scss 19:3 root stylesheet