Function getCompileFn

src/utils.js:650–705

* Verifies that the implementation and version of Sass is supported by this loader. * @template {SassImplementation} T * @param {LoaderContext} loaderContext loader context * @param {T} implementation sass implementation * @param {ApiType=} apiType api type * @returns {(sassOptions: SassOptions

(loaderContext, implementation, apiType = "auto")

 * @returns {(sassOptions: SassOptions & { data: string }) => Promise<CompileResult>} compile function
 */
function getCompileFn(loaderContext, implementation, apiType = "auto") {
  const { initAsyncCompiler } = implementation;

  if (
    apiType === "modern-compiler" ||
    (apiType === "auto" && typeof initAsyncCompiler === "function")
  ) {
    return async (
      /** @type {SassOptions & { data: string }} */ sassOptions,
    ) => {
      const webpackCompiler =
        /** @type {LoaderContext & { _compiler?: import("webpack").Compiler }} */
        (loaderContext)._compiler;
      const { data, ...rest } = sassOptions;

      // Some people can run the loader in a multi-threading way;
      // there is no webpack compiler object in such case.
      if (webpackCompiler && initAsyncCompiler) {
        if (!sassModernCompilers.has(webpackCompiler)) {
          // Create a long-running compiler process that can be reused
          // for compiling individual files.
          const compiler = await initAsyncCompiler();

          // Check again because awaiting the initialization function
          // introduces a race condition.
          if (!sassModernCompilers.has(webpackCompiler)) {
            sassModernCompilers.set(webpackCompiler, compiler);
            webpackCompiler.hooks.shutdown.tap("sass-loader", () => {
              compiler.dispose();
            });
          } else {
            compiler.dispose();
          }
        }

        return /** @type {AsyncCompiler} */ (
          sassModernCompilers.get(webpackCompiler)
        ).compileStringAsync(/** @type {string} */ (data), rest);
      }

      return implementation.compileStringAsync(
        /** @type {string} */ (data),
        rest,
      );
    };
  }

  return (/** @type {SassOptions & { data: string }} */ sassOptions) => {
    const { data, ...rest } = sassOptions;

    return implementation.compileStringAsync(
      /** @type {string} */ (data),
      rest,
    );
  };
}

const ABSOLUTE_SCHEME = /^[A-Za-z0-9+\-.]+:/;