sass-site/source/documentation/at-rules/debug.md
2023-06-21 15:20:03 -04:00

42 lines
1.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: "@debug"
introduction: >
Sometimes its useful to see the value of a
[variable](/documentation/variables) or
[expression](/documentation/syntax/structure#expressions) while youre
developing your stylesheet. Thats what the `@debug` rule is for: its written
`@debug <expression>`, and it prints the value of that expression, along with
the filename and line number.
---
{% codeExample 'debug', false %}
@mixin inset-divider-offset($offset, $padding) {
$divider-offset: (2 * $padding) + $offset;
@debug "divider offset: #{$divider-offset}";
margin-left: $divider-offset;
width: calc(100% - #{$divider-offset});
}
===
@mixin inset-divider-offset($offset, $padding)
$divider-offset: (2 * $padding) + $offset
@debug "divider offset: #{$divider-offset}"
margin-left: $divider-offset
width: calc(100% - #{$divider-offset})
{% endcodeExample %}
The exact format of the debug message varies from implementation to
implementation. This is what it looks like in Dart Sass:
```
test.scss:3 Debug: divider offset: 132px
```
{% funFact %}
You can pass any value to `@debug`, not just a string! It prints the same
representation of that value as the [`meta.inspect()` function][].
[`meta.inspect()` function]: /documentation/modules/meta#inspect
{% endfunFact %}