It generally non-payments to the current doing work list of the method you’re using to-name esbuild’s API. The functional list is used from the esbuild for many some other anything in addition to solving cousin routes offered since the API options to absolute routes and you may very-printing pure pathways once the cousin pathways in the record texts. Information about how in order to override they:
#JS-specific info
New node-oriented JS API will come in each other parallel and you can asynchronous styles, for each with assorted tradeoffs. It is essential to understand the distinctions to choose the correct one to suit your situation:
#Sync API
- To stop claims may cause vacuum cleaner code
- Work for the products that really must be synchronous such inside need .extensions
- You can not use plugins towards the synchronous API since plugins are asynchronous
- They stops the present day bond and that means you can’t create most other performs for the time being
- Using the synchronous API prevents esbuild out of parallelizing esbuild API phone calls
#Async API
- You can utilize plugins with the
asynchronous API - The current thread is not prohibited to help you carry out other operate in brand new meantime
- You can work at many parallel esbuild API calls at exactly the same time that are upcoming give all over all readily available CPUs for maximum overall performance
- Using pledges may cause messier password, especially in CommonJS in which top-peak wait a little for isn’t readily available
- Does not work for the items that must definitely be synchronous such as for example within this need .extensions
#Powering on the browser
New esbuild API can also run-in brand new web browser playing with WebAssembly from inside the an internet Staff member. For taking advantageous asset of so it make an effort to created new esbuild-wasm package rather than the esbuild package:
The brand new API towards the browser is similar to the fresh new API to have node besides you should name initialize() first, and you should solution new Website link of the WebAssembly digital. The brand new synchronous versions of your API also are not available. Whenever you’re playing with an effective bundler, who would search something similar to which:
If you’re currently running which password out of a member of staff plus don’t require initialize which will make other worker, you might violation staff: untrue to they. Then it can establish an excellent WebAssembly component in identical bond as the bond you to definitely phone calls initialize .
The fresh new API can be utilized in one of three ways: toward command range, in JavaScript, and in Go. The newest principles and you can parameters are mostly similar amongst the three dialects so that they will be presented together with her here in the place of which have separate files for each words.
There are two main API contacts esbuild’s API: changes and construct. It is important to see which one you should be playing with since it works differently.
If you are using JavaScript definitely take a look at JS-particular details point lower than. You may also find the TypeScript type of significance to have esbuild of good use because the a research. If you are using Wade make sure to browse the immediately produced Wade files.
If you utilize the brand new order-line API, it could be useful to know that this new flags come in certainly around three versions: –foo , –foo=bar , or –foo:club . The form –foo is used to possess enabling boolean flags particularly –minify , the shape –foo=bar is employed to own flags having a single worth and you may are just specified immediately following particularly –platform= , in addition to setting –foo:bar is utilized to possess flags having several viewpoints and will become re also-specified several times such as for example –external: .
#Alter API
Brand new changes API call works on a single string without availability to help you a file system. This makes it good for include in environment in the place of a file program (eg a web browser) otherwise as part of several other product strings. Here’s what an easy alter looks like:
Leave a Reply