A loader for webpack which transforms files into base64 URIs. 

A loader for webpack which transforms files into base64 URIs

evilebottnawi

sokra

d3viant0ne

jhnns

michael-ciniawsky

thelarkinn

url-loader

All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.

### [2.0.1](https://github.com/webpack-contrib/url-loader/compare/v2.0.0...v2.0.1) (2019-06-25)

* allow using limit as string when you use loader with query string ([#185](https://github.com/webpack-contrib/url-loader/issues/185)) ([4842f93](https://github.com/webpack-contrib/url-loader/commit/4842f93))

## [2.0.0](https://github.com/webpack-contrib/url-loader/compare/v1.1.2...v2.0.0) (2019-06-05)

* rm unnecessary `bin` field ([#163](https://github.com/webpack-contrib/url-loader/issues/163)) ([b603665](https://github.com/webpack-contrib/url-loader/commit/b603665))

* `limit` should always be a number and 0 value handles as number ([#180](https://github.com/webpack-contrib/url-loader/issues/180)) ([d82e453](https://github.com/webpack-contrib/url-loader/commit/d82e453))

* fallback loader will be used than limit is equal or greater ([#179](https://github.com/webpack-contrib/url-loader/issues/179)) ([3c24545](https://github.com/webpack-contrib/url-loader/commit/3c24545))

* limit option can be boolean ([#181](https://github.com/webpack-contrib/url-loader/issues/181)) ([60d2cb3](https://github.com/webpack-contrib/url-loader/commit/60d2cb3))

* minimum required nodejs version is `8.9.0`

* `limit` should always be a number and 0 value handles as number

* fallback loader will be used than limit is equal or greater (before only when greater)

## [1.1.2](https://github.com/webpack-contrib/url-loader/compare/v1.1.0...v1.1.2) (2018-10-10)

* fallback options behaviour ([#145](https://github.com/webpack-contrib/url-loader/issues/145)) ([03e631f](https://github.com/webpack-contrib/url-loader/commit/03e631f))

* **package:** add support for `webpack =< v3.0.0` (`peerDependencies`) ([#150](https://github.com/webpack-contrib/url-loader/issues/150)) ([a6860fc](https://github.com/webpack-contrib/url-loader/commit/a6860fc))

* **package:** relax `node` version range (`engines`) ([#155](https://github.com/webpack-contrib/url-loader/issues/155)) ([d37b108](https://github.com/webpack-contrib/url-loader/commit/d37b108))

* **utils/normalizeFallback:** correctly pass all `options` to the default fallback (`file-loader`) ([#139](https://github.com/webpack-contrib/url-loader/issues/139)) ([401be63](https://github.com/webpack-contrib/url-loader/commit/401be63))

## [1.1.1](https://github.com/webpack-contrib/url-loader/compare/v1.1.0...v1.1.1) (2018-08-17)

* correctly pass all `options` to the fallback ([#143](https://github.com/webpack-contrib/url-loader/issues/143)) ([03e631f](https://github.com/webpack-contrib/url-loader/commit/03e631f))

# [1.1.0](https://github.com/webpack-contrib/url-loader/compare/v1.0.1...v1.1.0) (2018-08-13)

* support fallback loader in options.fallback ([#123](https://github.com/webpack-contrib/url-loader/issues/123)) ([017adc7](https://github.com/webpack-contrib/url-loader/commit/017adc7)), closes [#118](https://github.com/webpack-contrib/url-loader/issues/118)

## [1.0.1](https://github.com/webpack-contrib/url-loader/compare/v1.0.0...v1.0.1) (2018-03-03)

* **index:** revert to CJS exports (`module.exports`) ([#116](https://github.com/webpack-contrib/url-loader/issues/116)) ([7b60cc2](https://github.com/webpack-contrib/url-loader/commit/7b60cc2))

# [1.0.0](https://github.com/webpack-contrib/url-loader/compare/v1.0.0-beta.0...v1.0.0) (2018-03-03)

* **index:** use `Buffer.from` instead of deprecated `new Buffer` ([#113](https://github.com/webpack-contrib/url-loader/issues/113)) ([457618b](https://github.com/webpack-contrib/url-loader/commit/457618b))

# [1.0.0-beta.0](https://github.com/webpack-contrib/url-loader/compare/v0.6.2...v1.0.0-beta.0) (2017-12-17)

* apply `webpack-defaults` ([#102](https://github.com/webpack-contrib/url-loader/issues/102)) ([073b588](https://github.com/webpack-contrib/url-loader/commit/073b588))

* Sets `engines` to `"node": ">= 6.9.0 || >= 8.9.0"`

## [0.6.2](https://github.com/webpack-contrib/url-loader/compare/v0.6.1...v0.6.2) (2017-10-04)

* allow use `limit` as string ([#96](https://github.com/webpack-contrib/url-loader/issues/96)) ([b31684d](https://github.com/webpack-contrib/url-loader/commit/b31684d))

Object.defineProperty(exports, "__esModule", {

var _loaderUtils = require("loader-utils");

var _schemaUtils = _interopRequireDefault(require("schema-utils"));

var _mime = _interopRequireDefault(require("mime"));

var _normalizeFallback = _interopRequireDefault(require("./utils/normalizeFallback"));

var _options = _interopRequireDefault(require("./options.json"));

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }

  if (typeof limit === 'number' || typeof limit === 'string') {

  const options = (0, _loaderUtils.getOptions)(this) || {};

  (0, _schemaUtils.default)(_options.default, options, 'URL Loader'); // No limit or within the specified limit

  if (shouldTransform(options.limit, src.length)) {

    const file = this.resourcePath; // Get MIME type

    const mimetype = options.mimetype || _mime.default.getType(file);

    return `module.exports = ${JSON.stringify(`data:${mimetype || ''};base64,${src.toString('base64')}`)}`;

  } = (0, _normalizeFallback.default)(options.fallback, options); // Require the fallback.

  const fallback = require(fallbackLoader); // Call the fallback, passing a copy of the loader context. The copy has the query replaced. This way, the fallback

  // loader receives the query which was intended for it instead of the query which was intended for url-loader.

  const fallbackLoaderContext = Object.assign({}, this, {

  return fallback.call(fallbackLoaderContext, src);

      "type": ["boolean", "number", "string"]

              "description": "Fallback loader name",

              "description": "Fallback loader options",

  "description": "A loader for webpack which transforms files into base64 URIs",

  "repository": "webpack-contrib/url-loader",

  "homepage": "https://github.com/webpack-contrib/url-loader",

  "bugs": "https://github.com/webpack-contrib/url-loader/issues",

    "build": "cross-env NODE_ENV=production babel src -d dist --ignore \"src/**/*.test.js\" --copy-files",

    "commitlint": "commitlint --from=master",

    "lint:prettier": "prettier \"{**/*,*}.{js,json,md,yml,css}\" --list-different",

    "lint:js": "eslint --cache src test",

    "lint": "npm-run-all -l -p \"lint:**\"",

    "test:only": "cross-env NODE_ENV=test jest",

    "test:watch": "cross-env NODE_ENV=test jest --watch",

    "test:coverage": "cross-env NODE_ENV=test jest --collectCoverageFrom=\"src/**/*.js\" --coverage",

    "test": "cross-env NODE_ENV=test npm run test:coverage",

    "@commitlint/config-conventional": "^8.0.0",

    "@webpack-contrib/defaults": "^5.0.0",

    "@webpack-contrib/defaults": "^5.0.1",

    "@webpack-contrib/eslint-config-webpack": "^3.0.0",

    "commitlint-azure-pipelines-cli": "^1.0.2",

A loader for webpack which transforms files into base64 URIs.

To begin, you'll need to install `url-loader`:

[`file-loader`](https://github.com/webpack-contrib/file-loader), but can return

a DataURL if the file is smaller than a byte limit.

And run `webpack` via your preferred method.

Specifies an alternative loader to use when a target file's size exceeds the

              fallback: 'responsive-loader',

The fallback loader will receive the same configuration options as url-loader.

For example, to set the quality option of a responsive-loader above use:

The limit can be specified via loader options and defaults to no limit.

A `Number` specifying the maximum size of a file in bytes. If the file size is

**equal** or **greater** than the limit [`file-loader`](https://github.com/webpack-contrib/file-loader)

will be used (by default) and all query parameters are passed to it.

Using an alternative to `file-loader` is enabled via the `fallback` option.

Enable or disable transform files into base64.

Sets the MIME type for the file to be transformed. If unspecified the file

extensions will be used to lookup the MIME type.

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

[CONTRIBUTING](./.github/CONTRIBUTING.md)

[npm]: https://img.shields.io/npm/v/url-loader.svg

[npm-url]: https://npmjs.com/package/url-loader

		@@ -32,3 +32,3 @@ "use strict";

		if (typeof limit === 'number') {
		if (typeof limit === 'number' \|\| typeof limit === 'string') {
		return size <= parseInt(limit, 10);
		@@ -35,0 +35,0 @@ }

		@@ -5,3 +5,3 @@ {
		"limit": {
		"type": ["boolean", "number"]
		"type": ["boolean", "number", "string"]
		},
		@@ -8,0 +8,0 @@ "mimetype": {

		{
		"name": "url-loader",
		"version": "2.0.0",
		"version": "2.0.1",
		"description": "A loader for webpack which transforms files into base64 URIs",
		@@ -41,3 +41,3 @@ "license": "MIT",
		"loader-utils": "^1.1.0",
		"mime": "^2.0.3",
		"mime": "^2.4.4",
		"schema-utils": "^1.0.0"
		@@ -51,3 +51,3 @@ },
		"@commitlint/config-conventional": "^8.0.0",
		"@webpack-contrib/defaults": "^5.0.0",
		"@webpack-contrib/defaults": "^5.0.1",
		"@webpack-contrib/eslint-config-webpack": "^3.0.0",
		@@ -59,15 +59,15 @@ "babel-jest": "^24.8.0",
		"del-cli": "^2.0.0",
		"eslint": "^5.16.0",
		"eslint-config-prettier": "^4.3.0",
		"eslint-plugin-import": "^2.17.3",
		"eslint": "^6.0.1",
		"eslint-config-prettier": "^5.1.0",
		"eslint-plugin-import": "^2.18.0",
		"file-loader": "^4.0.0",
		"husky": "^2.3.0",
		"husky": "^2.5.0",
		"jest": "^24.8.0",
		"jest-junit": "^6.4.0",
		"lint-staged": "^8.1.7",
		"lint-staged": "^8.2.1",
		"memory-fs": "^0.4.1",
		"npm-run-all": "^4.1.5",
		"prettier": "^1.17.1",
		"prettier": "^1.18.2",
		"standard-version": "^6.0.1",
		"webpack": "^4.33.0"
		"webpack": "^4.35.0"
		},
		@@ -74,0 +74,0 @@ "keywords": [

		@@ -121,3 +121,3 @@ <div align="center">

		Type: `Number\|Boolean`
		Type: `Number\|Boolean\|String`
		Default: `undefined`
		@@ -124,0 +124,0 @@

Improved metrics

Dependency changes

		@@ -5,2 +5,11 @@ # Changelog

		### [2.0.1](https://github.com/webpack-contrib/url-loader/compare/v2.0.0...v2.0.1) (2019-06-25)


		### Bug Fixes

		* allow using limit as string when you use loader with query string ([#185](https://github.com/webpack-contrib/url-loader/issues/185)) ([4842f93](https://github.com/webpack-contrib/url-loader/commit/4842f93))



		## [2.0.0](https://github.com/webpack-contrib/url-loader/compare/v1.1.2...v2.0.0) (2019-06-05)
		@@ -7,0 +16,0 @@