W3cubDocs

/Sass

initAsyncCompiler

  • Compatibility:
    Dart Sass
    since 1.70.0
    Node Sass

    Creates an asynchronous AsyncCompiler. Each compiler instance exposes the compileAsync and compileStringAsync methods within the lifespan of the Compiler. Given identical input, these methods will return results identical to their counterparts exposed at the module root. To use synchronous compilation, use initCompiler;

    When calling the compile functions multiple times, using a compiler instance with the sass-embedded npm package is much faster than using the top-level compilation methods or the sass npm package.

    Example

    constsass = require('sass');
    asyncfunctionsetup() {
    constcompiler = awaitsass.initAsyncCompiler();
    constresult1 = awaitcompiler.compileStringAsync('a {b: c}').css;
    constresult2 = awaitcompiler.compileStringAsync('a {b: c}').css;
    awaitcompiler.dispose();

    // throws error
    constresult3 = awaitsass.compileStringAsync('a {b: c}').css;
    }

    Returns Promise<AsyncCompiler>

© 2006–2025 the Sass team, and numerous contributors
Licensed under the MIT License.
https://sass-lang.com/documentation/js-api/functions/initAsyncCompiler