1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
#/
# @license Apache-2.0
#
# Copyright (c) 2017 The Stdlib Authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#/
# VARIABLES #
# Define the path to the browserify plugin which allows proxyquire to be run in a browser:
BROWSERIFY_PROXYQUIRE ?= $(NODE_MODULES)/proxyquire-universal
# Define command-line options to be used when invoking the browserify executable:
BROWSERIFY_BROWSER_TEST_FLAGS ?= -p $(BROWSERIFY_PROXYQUIRE)
# DEPENDENCIES #
# Browser test runner.
#
# All test runners are expected to output TAP.
ifeq ($(BROWSER_TEST_RUNNER), testling)
include $(TOOLS_MAKE_LIB_DIR)/test-browsers/testling.mk
endif
# TARGETS #
# Run unit tests in a (headless) browser.
#
# This target [browserifies][1] test files (and the [proxyquire-universal][2] plugin), runs unit tests in a local (headless) browser using a specified test runner, and pipes output to a TAP reporter which is expected to be [tap-spec][3].
#
# To install `browserify`, `proxyquire-universal`, and `tap-spec`:
#
# ```bash
# $ npm install browserify proxyquire-universal tap-spec
# ```
#
# [1]: https://github.com/substack/node-browserify
# [2]: https://github.com/bendrucker/proxyquire-universal
# [3]: https://github.com/scottcorgan/tap-spec
#
# TODO: make robust to long file lists.
test-browsers: $(NODE_MODULES)
$(QUIET) NODE_ENV="$(NODE_ENV_TEST)" \
NODE_PATH="$(NODE_PATH_TEST)" \
$(BROWSERIFY) \
$(BROWSERIFY_BROWSER_TEST_FLAGS) \
$(TESTS) \
| $(BROWSER_TEST) $(BROWSER_TEST_FLAGS) \
| $(TAP_REPORTER)
.PHONY: test-browsers
# View browser tests in a local web browser.
#
# This target runs unit tests in a local web browser.
view-browser-tests:
ifeq ($(BROWSER_TEST_RUNNER), testling)
$(QUIET) $(MAKE) -f $(this_file) view-testling
endif
.PHONY: view-browser-tests
|
