esbuild-plugin-copy
Inhalt der Doku

esbuild-plugin-copy · Doku

Überblick

esbuild-Plugin, das nach jedem Build einen Ordner oder eine Datei in das Ausgabeverzeichnis kopiert, etwa statische Assets aus public/.

Auf dieser Seite

esbuild bündelt dein JavaScript und CSS nach dist/. Statische Dateien wie index.html, Bilder oder robots.txt musst du selbst dorthin bringen. esbuild-copy-plugin übernimmt das: Nach jedem Build kopiert es einen Ordner oder eine Datei in das Ausgabeverzeichnis.

Kurzbeispiel

import esbuild from 'esbuild';
import copy from 'esbuild-copy-plugin';

await esbuild.build({
    entryPoints: ['./src/index.js'],
    bundle:      true,
    outfile:     './dist/index.js',
    plugins:     [
        copy({from: './public', to: '.'}),
    ],
});

Danach liegt der Inhalt von public/ direkt neben dist/index.js.

Was das Plugin macht

  • Es hängt sich an das onEnd von esbuild und kopiert nach jedem Build, im Watch-Modus also nach jedem Rebuild.
  • Es kopiert rekursiv, überschreibt vorhandene Dateien und löst symbolische Links auf (kopiert wird der Inhalt, nicht der Link).
  • Das Ziel liegt immer relativ zum Ordner von outfile.

Status

Version 1.0.0, geschrieben 2021. Getestet mit esbuild 0.28 und Node.js 22.

Wichtig

Das Plugin braucht outfile. Mit outdir bricht der Build ab. Alle Grenzen stehen unter Optionen.

Verwandte Pakete

Die drei esbuild-Plugins sind als Satz gedacht: