esbuild-plugin-copy
Inhalt der Doku

esbuild-plugin-copy · Doku

Optionen

Alle Optionen von esbuild-copy-plugin, das feste Kopierverhalten und die bekannten Grenzen.

Auf dieser Seite

copy() nimmt ein Objekt mit zwei Pflichtfeldern und gibt ein esbuild-Plugin mit dem Namen copy zurück.

copy({from: './public', to: '.'})

Optionen

Name Typ Standard Beschreibung
from string Pflicht Ordner oder Datei, die kopiert wird. Relativ zum Ordner, aus dem du den Build startest
to string Pflicht Ziel relativ zum Ordner von outfile. . heißt: direkt in diesen Ordner. Bei einer Datei der Zielname

Ein Beispiel mit outfile: './dist/index.js':

from to Ergebnis
./public . Inhalt von public/ in dist/
./public static Inhalt von public/ in dist/static/
./config/robots.txt robots.txt dist/robots.txt

Festes Verhalten

Diese Einstellungen gibt das Plugin an fs.cpSync weiter. Ändern kannst du sie nicht.

Einstellung Wert Wirkung
recursive true Ordner werden mit allen Unterordnern kopiert
force true Vorhandene Dateien im Ziel werden überschrieben
dereference true Symbolische Links werden aufgelöst, kopiert wird ihr Inhalt

Dateien, die im Ziel liegen, aber nicht mehr in der Quelle, löscht das Plugin nicht. Dafür gibt es esbuild-plugin-clear.

Einschränkungen

Diese Punkte gelten für Version 1.0.0:

  • Nur mit outfile. Das Ziel wird aus dem Ordner von outfile berechnet. Nutzt du outdir, bricht der Build mit „The "path" argument must be of type string“ ab.
  • Kopiert auch nach einem fehlgeschlagenen Build. Das Plugin prüft das Ergebnis von esbuild nicht.
  • from ist relativ zum aktuellen Ordner des Prozesses, nicht zu absWorkingDir. Startest du den Build aus einem anderen Ordner, findet das Plugin die Quelle nicht.
  • to bleibt immer im Ausgabeordner. Auch ein absoluter Pfad wird an den Ordner von outfile angehängt.
  • Fehlt die Quelle, schlägt der Build fehl, mit dem rohen Fehler von Node.js (ENOENT: no such file or directory).
  • Eine einzelne Datei braucht einen Zielnamen in to, siehe Verwendung.

Tipp

Arbeitest du mit outdir, setz für diesen Build stattdessen outfile oder kopier die Dateien in einem eigenen Schritt nach dem Build.