{"id":20619,"library":"transform-loader","title":"transform-loader","description":"Webpack loader that allows using browserify transforms in webpack builds. Version 0.2.4 is the latest stable release (last updated 2017). It enables reuse of existing browserify transform modules (like brfs, coffeeify) within webpack's loader pipeline. Key differentiator: bridges browserify ecosystem transforms to webpack without manual porting. Supports webpack 1.x and 2.x but is not actively maintained.","status":"maintenance","version":"0.2.4","language":"javascript","source_language":"en","source_url":"ssh://git@github.com/webpack/transform-loader","tags":["javascript"],"install":[{"cmd":"npm install transform-loader","lang":"bash","label":"npm"},{"cmd":"yarn add transform-loader","lang":"bash","label":"yarn"},{"cmd":"pnpm add transform-loader","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required as a loader plugin for webpack","package":"webpack","optional":false}],"imports":[{"note":"Loader is typically used in webpack config as string reference, not directly imported in code.","wrong":"const transformLoader = require('transform-loader')","symbol":"default import","correct":"import transformLoader from 'transform-loader'"},{"note":"Use the subpath '/cacheable' to enable caching, not a query parameter.","wrong":"import 'transform-loader?cacheable'","symbol":"cacheable variant","correct":"import 'transform-loader/cacheable'"},{"note":"Loader is configured via webpack config with query string; no direct import needed.","wrong":"","symbol":"Webpack config usage","correct":"module.exports = { module: { rules: [{ test: /\\.js$/, loader: 'transform-loader?brfs' }] } }"}],"quickstart":{"code":"// webpack.config.js\nmodule.exports = {\n  context: __dirname,\n  entry: './index.js',\n  module: {\n    loaders: [\n      {\n        test: /\\.js$/,\n        loader: 'transform-loader?brfs'\n      }\n    ]\n  }\n};","lang":"javascript","description":"Configures webpack to use the brfs browserify transform via transform-loader on all JavaScript files."},"warnings":[{"fix":"For webpack 2+, use 'enforce: post' in rule or migrate to webpack-native loaders.","message":"transform-loader uses deprecated loader API in webpack 2+","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"Use 'transform-loader/cacheable?brfs' instead of 'transform-loader?brfs&cacheable'.","message":"Cacheable variant must be imported as subpath '/cacheable' not as query parameter","severity":"gotcha","affected_versions":"all"},{"fix":"Define transforms directly in rule options: { loader: 'transform-loader', options: { transforms: [...] } } or avoid using plugin-based transforms.","message":"Webpack 5 removed LoaderOptionsPlugin, breaking configs using plugin transform index","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Use 'transform-loader/cacheable' variant or narrow test pattern to specific files.","message":"Applied to all files in default config, causing performance degradation in watch mode","severity":"gotcha","affected_versions":"all"},{"fix":"Consider using alternative loaders like brfs directly or migrate to webpack-native solutions.","message":"Project last updated in 2017; no webpack 5 support","severity":"deprecated","affected_versions":">0.2.4"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Ensure 'transform-loader' is installed: npm install transform-loader --save-dev","cause":"Incorrect subpath import or missing npm install","error":"Module not found: Error: Can't resolve 'transform-loader/cacheable'"},{"fix":"Upgrade to webpack 5 and consider using alternatives like 'brfs' loader directly","cause":"Using transform-loader with webpack 4+ which deprecates old loader utilities","error":"Error: DeprecationWarning: loaderUtils.getOptions is deprecated"},{"fix":"Use webpack 4 or migrate to a maintained loader like 'brfs-loader'","cause":"transform-loader not compatible with webpack 5's loader API","error":"TypeError: this.getOptions is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}