Makefile

#/
# @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