Optionalpathprovide an alternate path to place this resource.
if a relative path is provided (which is what is recommended),
then this file will be placed relative to the cwd or absWorkingDir specified in the initial build options,
which is different from the outdir. for providing paths relative to outdir, use an absolute path.
TODO: in the future, consider adding a pathRelativeTo option, with the symbols OUTDIR, CWD, and ABS_WORKING_DIR,
for specifying what is the path relative to.
Optionalcontentsthe contents of the file after you've re-incorporated the imported/dependency links into it.
if left undefined, then the original OnEmitArgs.contents will be used as its value.
Optionalwritespecify if the file should be written (i.e. emitted) at all.
note that it is totally possible to delete an entity, but still have some contents assigned to it. this way, you should be able to read the contents of the "deleted" file later on inside on of the dependent entities.
this can be useful when you would like to code a plugin that takes in inlined code (such as inlined js or css inside an html), then includes it in the bundle (by faking it as virtual files during resolutions/loading), and then deletes the emitted files corresponding to the inlined code blocks, while retaining the minified/bundled contents, so that the original dependent entity (html file in this case) can read the minified/bundled contents and then re-incorporate them as inlined code.
(TODO: though, right now, I don't currently give a global readonly access to the output files registry inside the OnEmitCallback function. I should probably add the registry as a second argument to the callback function.)
type alias for
esbuild.OnEndResult.