| """# Toolchains |
| |
| API docs for [Toolchain](https://docs.bazel.build/versions/main/toolchains.html) support. |
| |
| When you call `nodejs_register_toolchains()` in your `WORKSPACE` file it will setup a node toolchain for executing tools on all currently supported platforms. |
| |
| If you have an advanced use-case you can also register your own toolchains. See [node_toolchain](./Core.md#node_toolchain) |
| |
| ## Node.js binary for the target platform |
| |
| Sometimes your target platform (where your software runs) is different from the host platform (where you run Bazel) or execution platform (where Bazel actions run). |
| The most common case is developing a docker image on MacOS, which will execute in a Linux container. |
| |
| Our toolchain support is conditional on the execution platform, as it's meant for running nodejs tools during the build. |
| It is not needed for this use case. Instead, simply select the nodejs you want to include in the runtime. |
| |
| For example, rules_docker has a `nodejs_image` rule, which takes a `node_repository_name` attribute indicating |
| which nodejs binary you want to include in the image. `nodejs_linux_amd64` is the value you'd use. |
| |
| ## Cross-compilation |
| |
| Bazel Toolchains are intended to support cross-compilation, e.g. building a linux binary from mac or windows. |
| Most JavaScript use cases produce platform-independent code, |
| but the exception is native modules which use [node-gyp](https://github.com/nodejs/node-gyp). |
| Any native modules will still be fetched and built, by npm/yarn, for your host platform, |
| so they will not work on the target platform. |
| The workaround is to perform the npm_install inside a docker container so that it produces modules for the target platform. |
| |
| Follow https://github.com/bazelbuild/rules_nodejs/issues/506 for updates on support for node-gyp cross-compilation. |
| |
| ## node_toolchain |
| |
| See <./Core.md#node_toolchain> |
| |
| """ |
| |
| load("//toolchains/cypress:cypress_repositories.bzl", _cypress_repositories = "cypress_repositories") |
| load("//toolchains/cypress:cypress_toolchain.bzl", _cypress_toolchain = "cypress_toolchain") |
| load("//toolchains/esbuild:esbuild_repositories.bzl", _esbuild_repositories = "esbuild_repositories") |
| load("//toolchains/esbuild:toolchain.bzl", _configure_esbuild_toolchains = "configure_esbuild_toolchains") |
| |
| cypress_repositories = _cypress_repositories |
| cypress_toolchain = _cypress_toolchain |
| esbuild_repositories = _esbuild_repositories |
| configure_esbuild_toolchains = _configure_esbuild_toolchains |
