sass-site/source/documentation/modules/meta.html.md.erb

---
title: sass:meta
---

<%= partial '../snippets/built-in-module-status' %>

<% function 'meta.call($function, $args...)', 'call($function, $args...)' do %>
  <%= partial 'documentation/snippets/call-impl-status' %>

  Invokes `$function` with `$args` and returns the result.

  The `$function` should be a [function][] returned by
  [`meta.get-function()`][].

  [function]: ../values/functions
  [`meta.get-function()`]: #get-function

  <%= partial 'code-snippets/example-first-class-function' %>
<% end %>


<% function 'meta.content-exists()',
            'content-exists()',
            returns: 'boolean' do %>
  Returns whether the current mixin was passed a [`@content` block][].

  [`@content` block]: ../at-rules/mixin#content-blocks

  Throws an error if called outside of a mixin.

  <% example(autogen_css: false) do %>
    @mixin debug-content-exists {
      @debug meta.content-exists();
      @content;
    }

    @include debug-content-exists; // false
    @include debug-content-exists { // true
      // Content!
    }
    ===
    @mixin debug-content-exists
      @debug meta.content-exists()
      @content


    @include debug-content-exists  // false
    @include debug-content-exists   // true
      // Content!
  <% end %>
<% end %>


<% function 'meta.feature-exists($feature)',
            'feature-exists($feature)',
            returns: 'boolean' do %>
  Returns whether the current Sass implementation supports `$feature`.

  The `$feature` must be a string. The currently recognized features are:

  * `global-variable-shadowing`, which means that a local variable will
    [shadow][] a global variable unless it has the `!global` flag.
  * `extend-selector-pseudoclass`, which means that the [`@extend` rule][] will
    affect selectors nested in pseudo-classes like `:not()`.
  * `units-level3`, which means that [unit arithmetic][] supports units defined
    in [CSS Values and Units Level 3][].
  * `at-error`, which means that the [`@error` rule][] is supported.
  * `custom-property`, which means that [custom property declaration][] values
    don't support any [expressions][] other than [interpolation][].

  [shadow]: ../variables#shadowing
  [`@extend` rule]: ../at-rules/extend
  [unit arithmetic]: ../values/numbers#units
  [CSS Values and Units Level 3]: http://www.w3.org/TR/css3-values
  [`@error` rule]: ../at-rules/error
  [custom property declaration]: ../style-rules/declarations#custom-properties
  [expressions]: ../syntax/structure#expressions
  [interpolation]: ../interpolation

  Returns `false` for any unrecognized `$feature`.

  <% example(autogen_css: false) do %>
    @debug meta.feature-exists("at-error"); // true
    @debug meta.feature-exists("unrecognized"); // false
    ===
    @debug meta.feature-exists("at-error")  // true
    @debug meta.feature-exists("unrecognized")  // false
  <% end %>
<% end %>


<% function 'meta.function-exists($name)',
            'function-exists($name)',
            returns: 'boolean' do %>
  Returns whether a function named `$name` is defined, either as a built-in
  function or a user-defined function.

  <% example(autogen_css: false) do %>
    @debug meta.function-exists("scale-color"); // true
    @debug meta.function-exists("add"); // false

    @function add($num1, $num2) {
      @return $num1 + $num2;
    }
    @debug meta.function-exists("add"); // true
    ===
    @debug meta.function-exists("scale-color")  // true
    @debug meta.function-exists("add")  // false

    @function add($num1, $num2)
      @return $num1 + $num2

    @debug meta.function-exists("add")  // true
  <% end %>
<% end %>


<% function 'meta.get-function($name, $css: false)',
            'get-function($name, $css: false)',
            returns: 'function' do %>
  Returns the [function][] named `$name`.

  [function]: ../values/functions

  This can access both built-in and [user-defined][] functions. By default, it
  throws an error if `$name` doesn't refer to either a built-in or user-defined
  function. However, if `$css` is `true`, it instead returns a
  [plain CSS function][].

  [user-defined]: ../at-rules/function
  [plain CSS function]: ../at-rules/function#plain-css-functions

  The returned function can be called using [`meta.call()`](#call).

  <%= partial 'code-snippets/example-first-class-function' %>
<% end %>


<% function 'meta.global-variable-exists($name)',
            'global-variable-exists($name)',
            returns: 'boolean' do %>
  Returns whether a [global variable][] named `$name` (without the `$`) exists.

  [global variable]: ../variables#scope

  See also [`meta.variable-exists()`](#variable-exists).

  <% example(autogen_css: false) do %>
    @debug meta.global-variable-exists("var1"); // false

    $var1: value;
    @debug meta.global-variable-exists("var1"); // true

    h1 {
      // $var2 is local.
      $var2: value;
      @debug meta.global-variable-exists("var2"); // false
    }
    ===
    @debug meta.global-variable-exists("var1")  // false

    $var1: value 
    @debug meta.global-variable-exists("var1")  // true

    h1
      // $var2 is local.
      $var2: value
      @debug meta.global-variable-exists("var2")  // false
  <% end %>
<% end %>


<% function 'meta.inspect($value)',
            'inspect($value)',
            returns: 'unquoted string' do %>
  Returns a string representation of `$value`.
  
  Returns a representation of *any* Sass value, not just those that can be
  represented in CSS. As such, its return value is not guaranteed to be valid
  CSS.

  <% heads_up do %>
    This function is intended for debugging; its output format is not guaranteed
    to be consistent across Sass versions or implementations.
  <% end %>

  <% example(autogen_css: false) do %>
    @debug meta.inspect(10px 20px 30px); // unquote("10px 20px 30px")
    @debug meta.inspect(("width": 200px)); // unquote('("width": 200px)')
    @debug meta.inspect(null); // unquote("null")
    @debug meta.inspect("Helvetica"); // unquote('"Helvetica"')
    ===
    @debug meta.inspect(10px 20px 30px)  // unquote("10px 20px 30px")
    @debug meta.inspect(("width": 200px))  // unquote('("width": 200px)')
    @debug meta.inspect(null)  // unquote("null")
    @debug meta.inspect("Helvetica")  // unquote('"Helvetica"')
  <% end %>
<% end %>


<% function 'meta.keywords($args)', 'keywords($args)', returns: 'map' do %>
  Returns the keywords passed to a mixin or function that takes [arbitrary
  arguments][]. The `$args` argument must be an [argument list][].

  [arbitrary arguments]: ../at-rules/mixin#taking-arbitrary-arguments
  [argument list]: ../values/lists#argument-lists

  The keywords are returned as a map from argument names as unquoted strings (not
  including `$`) to the values of those arguments.

  <%= partial 'code-snippets/example-mixin-arbitrary-keyword-arguments' %>
<% end %>


<% function 'meta.mixin-exists($name)',
            'mixin-exists($name)',
            returns: 'boolean' do %>
  Returns whether a [mixin][] named `$name` exists.

  [mixin]: ../at-rules/mixin

  <% example(autogen_css: false) do %>
    @debug meta.mixin-exists("shadow-none"); // false

    @mixin shadow-none {
      box-shadow: none;
    }

    @debug meta.mixin-exists("shadow-none"); // true
    ===
    @debug meta.mixin-exists("shadow-none")  // false

    @mixin shadow-none
      box-shadow: none


    @debug meta.mixin-exists("shadow-none")  // true
  <% end %>
<% end %>


<% function 'meta.type-of($value)',
            'type-of($value)',
            returns: 'unquoted string' do %>
  Returns the type of `$value`.

  This can return the following values:

  * [`number`](../values/numbers)
  * [`string`](../values/strings)
  * [`color`](../values/colors)
  * [`list`](../values/lists)
  * [`map`](../values/maps)
  * [`bool`](../values/booleans)
  * [`null`](../values/null)
  * [`function`](../values/functions)
  * [`arglist`](../values/lists#argument-lists)

  New possible values may be added in the future. It may return either `list` or
  `map` for `()`, depending on whether or not it was returned by a
  [map function][].

  [map function]: map

  <% example(autogen_css: false) do %> 
    @debug meta.type-of(10px); // number
    @debug meta.type-of(10px 20px 30px); // list
    @debug meta.type-of(()); // list
    ===
    @debug meta.type-of(10px)  // number
    @debug meta.type-of(10px 20px 30px)  // list
    @debug meta.type-of(())  // list
  <% end %>
<% end %>


<% function 'meta.variable-exists($name)',
            'variable-exists($name)',
            returns: 'boolean' do %>
  Returns whether a variable named `$name` (without the `$`) exists in the
  current [scope][].

  [scope]: ../variables#scope

  See also [`meta.global-variable-exists()`](#global-variable-exists).

  <% example(autogen_css: false) do %>
    @debug meta.variable-exists("var1"); // false

    $var1: value;
    @debug meta.variable-exists("var1"); // true

    h1 {
      // $var2 is local.
      $var2: value;
      @debug meta.variable-exists("var2"); // true
    }
    ===
    @debug meta.variable-exists("var1")  // false

    $var1: value 
    @debug meta.variable-exists("var1")  // true

    h1
      // $var2 is local.
      $var2: value
      @debug meta.variable-exists("var2")  // true
  <% end %>
<% end %>