coffee-loader

Compile CoffeeScript to JavaScript.

Getting Started

To begin, you'll need to install coffeescript and coffee-loader:

npm install --save-dev coffeescript coffee-loader

or

yarn add -D coffeescript coffee-loader

or

pnpm add -D coffeescript coffee-loader

Then add the plugin to your webpack config. For example:

file.coffee

# Assignment:
number   = 42
opposite = true

# Conditions:
number = -42 if opposite

# Functions:
square = (x) -> x * x

# Arrays:
list = [1, 2, 3, 4, 5]

# Objects:
math =
  root:   Math.sqrt
  square: square
  cube:   (x) -> x * square x

# Splats:
race = (winner, runners...) ->
  print winner, runners

# Existence:
alert "I knew it!" if elvis?

# Array comprehensions:
cubes = (math.cube num for num in list)

webpack.config.js

module.exports = {
  module: {
    rules: [
      {
        test: /\.coffee$/,
        loader: "coffee-loader",
      },
    ],
  },
};

Alternative usage:

import coffee from "coffee-loader!./file.coffee";

And run webpack via your preferred method.

Options

Type: Object Default: { bare: true }

Options for CoffeeScript. All possible options you can find here.

Documentation for the transpile option you can find here.

Note

The sourceMap option takes a value from the compiler.devtool value by default.

Note

The filename option takes a value from webpack loader API. The option value will be ignored.

webpack.config.js

module.exports = {
  module: {
    rules: [
      {
        test: /\.coffee$/,
        loader: "coffee-loader",
        options: {
          bare: false,
          transpile: {
            presets: ["@babel/env"],
          },
        },
      },
    ],
  },
};

Examples

CoffeeScript and Babel

From CoffeeScript 2 documentation:

Note

CoffeeScript 2 generates JavaScript that uses the latest, modern syntax. The runtime or browsers where you want your code to run might not support all of that syntax. In that case, we want to convert modern JavaScript into older JavaScript that will run in older versions of Node or older browsers; for example, { a } = obj into a = obj.a. This is done via transpilers like Babel, Bublé or Traceur Compiler.

You'll need to install @babel/core and @babel/preset-env and then create a configuration file:

npm install --save-dev @babel/core @babel/preset-env
echo '{ "presets": ["@babel/env"] }' > .babelrc

webpack.config.js

module.exports = {
  module: {
    rules: [
      {
        test: /\.coffee$/,
        loader: "coffee-loader",
        options: {
          transpile: {
            presets: ["@babel/env"],
          },
        },
      },
    ],
  },
};

Literate CoffeeScript

For using Literate CoffeeScript you should setup:

webpack.config.js

module.exports = {
  module: {
    rules: [
      {
        test: /\.coffee$/,
        loader: "coffee-loader",
        options: {
          literate: true,
        },
      },
    ],
  },
};

Contributing

Please take a moment to read our contributing guidelines if you haven't yet done so.

CONTRIBUTING

License

MIT

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

5.0.0 (2024-01-15)

⚠ BREAKING CHANGES

• minimum supported Node.js version is 18.12.0 (#174) (1d4adfd)

4.0.0 (2022-05-18)

⚠ BREAKING CHANGES

• minimum supported Node.js version is 14.15.0

3.0.0 (2021-05-11)

⚠ BREAKING CHANGES

• minimum supported Node.js version is 12.13.0

2.0.0 (2020-12-22)

⚠ BREAKING CHANGES

• minimum supported webpack version is 5

1.0.1 (2020-10-09)

Chore

• update schema-utils

1.0.0 (2020-05-22)

BREAKING CHANGES

• minimum required Node.js version is 10.13.0
• minimum required webpack version is 4.0.0
• minimum required coffeescript version is 2.0.0
• default value for the sourceMap option based on the value of the compiler.devtool option

Features

• respect the compiler.devtool value for the sourceMap option
• developer can override CoffeeScript options

Bug Fixes

• fix error reporting

0.9.0 (2017-10-25)

Features

• add transpile option (options.transpile) (#47) (abaf498)

0.8.0 (2017-08-23)

Bug Fixes

• #25: fix coffee-script dependency version (@jacobthemyth) (69ebdf4)
• getOptions: deprecation warn in loaderUtils (#28) (4e6b430)

Features

• add support for coffeescript 2 dependency (#30) (e5c24cc)