@imgproxy/imgproxy-js-core

Website | Blog | Documentation | imgproxy Pro | Docker | Twitter | Discord

---

imgproxy is a fast and secure standalone server for resizing and converting remote images. The main principles of imgproxy are simplicity, speed, and security. It is a Go application, ready to be installed and used in any Unix environment—also ready to be containerized using Docker.

imgproxy can be used to provide a fast and secure way to get rid of all the image resizing code in your web application (like calling ImageMagick or GraphicsMagick, or using libraries), while also being able to resize everything on the fly on a separate server that only you control. imgproxy is fast, easy to use, and requires zero processing power or storage from the main application. imgproxy is indispensable when handling image resizing of epic proportions, especially when original images are coming from a remote source.

imgproxy-js-core package is designed to be used as part of framework-specific packages and plugins.

• Install
• Usage
• Methods
• Development

Install

npm install @imgproxy/imgproxy-js-core

Usage

import { generateUrl } from "@imgproxy/imgproxy-js-core";

const url = generateUrl(
  {
    value: "https://example.com/image.jpg",
    type: "plain",
  },
  {
    width: 150,
    height: 150,
    format: "webp",
    quality: 80,
    enlarge: "t",
    extend: {
      extend: 1,
      gravity: { type: "nowe", y_offset: 5 },
    },
    blur: 5,
    zoom: 1.5,
  }
);

Methods

generateUrl(URL, options)

This method generates an imgproxy URL based on the provided source and options.

The imgproxy-js-core library exposes a method called generateUrl, which takes two arguments:

• URL (required): An object that contains the value and type properties.
  • value (required): A string that contains the URL of the image.
  • type (optional): A string that specifies the type of the URL. It can be one of the following:
    • plain: A plain URL.
    • base64: A base64 encoded URL.
    • encoded: An AES-CBC encrypted URL.
• options (optional): An object that contains imgproxy options.

For a detailed description of the available options, please refer to the imgproxy documentation, as well as the option types files in the imgproxy-js-core library.

The generateUrl method returns a string that contains the generated URL.

generateImageInfoUrl(URL, options)

This method ia available only for the PRO version of imgproxy.

This method generates an imgproxy URL based on the provided source and options.

The imgproxy-js-core library exposes a method called generateImageInfoUrl, which takes two arguments:

• URL (required): An object that contains the value and type properties.
  • value (required): A string that contains the URL of the image.
  • type (optional): A string that specifies the type of the URL. It can be one of the following:
    • plain: A plain URL.
    • base64: A base64 encoded URL.
    • encoded: An AES-CBC encrypted URL.
• options (optional): An object that contains imgproxy options.

For a detailed description of the available options, please refer to the imgproxy documentation, as well as the option types files in the imgproxy-js-core library.

The generateImageInfoUrl method returns a string that contains the generated URL.

Development

1. Clone the repo
2. Install dependencies

npm install

3. Run dev server

npm run dev