@bazel/jasmine

Jasmine rules for Bazel

The Jasmine rules run tests under the Jasmine framework with Bazel.

Installation

Add the @bazel/jasmine npm package to your devDependencies in package.json.

Your WORKSPACE should declare a yarn_install or npm_install rule named npm. It should then install the rules found in the npm packages using the install_bazel_dependencies function.

This causes the @bazel/jasmine package to be installed as a Bazel workspace named npm_bazel_jasmine.

jasmine_node_test

Runs tests in NodeJS using the Jasmine test runner.

Detailed XML test results are found in the standard bazel-testlogs directory. This may be symlinked in your workspace. See https://docs.bazel.build/versions/master/output_directories.html

To debug the test, see debugging notes in nodejs_test.

Usage

jasmine_node_test(name, srcs, data, deps, expected_exit_code, tags, config_file, coverage, jasmine, jasmine_entry_point, kwargs)

name

Name of the resulting label

srcs

JavaScript source files containing Jasmine specs

Defaults to []

data

Runtime dependencies which will be loaded while the test executes

Defaults to []

deps

Other targets which produce JavaScript, such as ts_library

Defaults to []

expected_exit_code

The expected exit code for the test.

Defaults to 0

tags

Bazel tags applied to test

Defaults to []

config_file

(experimental) label of a file containing Jasmine JSON config.

Note that not all configuration options are honored, and we expect some strange feature interations. For example, the filter for which files are instrumented for code coverage doesn't understand the spec_files setting in the config.

See https://jasmine.github.io/setup/nodejs.html#configuration

Defaults to None

coverage

Enables code coverage collection and reporting.

Defaults to False

jasmine

A label providing the @bazel/jasmine npm dependency.

Defaults to "@npm//@bazel/jasmine"

jasmine_entry_point

A label providing the @bazel/jasmine entry point.

Defaults to "@npm//:node_modules/@bazel/jasmine/jasmine_runner.js"

kwargs

Remaining arguments are passed to the test rule

Changelog

1.6.0 (2020-04-11)

Features

• builtin: export version to npm/yarn install (011278e)
• jasmine: check pkg version to rules_nodejs (22bebbc)
• typescript: wire up use_angular_plugin attribute (520493d)

Bug Fixes

• builtin: always symlink node_modules at execroot/my_wksp/node_modules even when running in runfiles (#1805) (5c2f6c1)
• builtin: don't allow symlinks to escape or enter bazel managed node_module folders (#1800) (4554ce7)
• builtin: fix for pkg_npm single directory artifact dep case (5a7c1a7)
• builtin: fix node patches lstat short-circuit logic (#1818) (b0627be)
• builtin: fix npm_version_check.js when running outside of bazel (#1802) (afabe89)
• builtin: look in the execroot for nodejs_binary source entry_points (#1816) (b84d65e), closes #1787 #1787
• builtin: preserve lone $ in templated_args for legacy support (#1772) (72c14d8)
• builtin: under runfiles linker should link node_modules folder at root of runfiles tree (13510ad)
• rollup: fix worker not picking up config file changes (a19eb2b), closes #1790
• typescript: don't mix worker mode and linker (55c6c4a), closes #1803 #1803
• typescript: include extended tsconfigs in _TsConfigInfo (cd8520d), closes #1754

Examples

• examples: add support for server side rendering with universal (c09ca89)
• examples: build and consume an Angular workspace library (#1633) (b459d6d)

Documentation

• docs: yarn_urls should be string_list, not string (3357c08)