blob: 01005845f4a2a975515f55f73852e1ec35d4aabd [file] [log] [blame]
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at
# Abort when an error occurs.
set -e
# Updates the jstests copy of the test cases of Test262, the conformance test
# suite for ECMA-262 and ECMA-402, ECMAScript and its Internationalization API.
function usage()
echo "Usage: <URL of test262 hg> [clone | copy]"
echo ""
echo "The URL will most commonly be "
echo "but may also be a local clone. Don't use a local clone when generating"
echo "the final import patch"\!" test262/HG-INFO will record the wrong URL"
echo "if you do so. Local cloning is only useful when editing this script to"
echo "import a larger test262 subset."
echo ""
echo "If a local clone is specified, the optional clone/copy argument will"
echo "either clone into a temporary directory, or directly copy from the"
echo "clone's checkout. 'clone' semantics are the default."
exit 1
if [ $# -lt 1 ]; then
elif [ $# -eq 1 -o "$2" == "clone" ]; then
# Beware! 'copy' support requires that the clone performed here *never* be
# altered. If it were altered, those changes wouldn't appear in the final
# set of changes as determined by the 'copy' path below.
# Mercurial doesn't have a way to download just a part of a repository, or to
# just get the working copy - we have to clone the entire thing. We use a
# temporary test262 directory for that.
unique_dir=`mktemp -d /tmp/test262.XXXX` || exit 1
# Remove the temporary test262 directory on exit.
function cleanupTempFiles()
rm -rf ${unique_dir}
trap cleanupTempFiles EXIT
echo "Feel free to get some coffee - this could take a few minutes..."
hg clone $1 ${tmp_dir}
elif [ "$2" == "copy" ]; then
echo "Copying directly from $1; be sure this repository is updated to tip"\!
# Now to the actual test262 directory.
js_src_tests_dir=`dirname $0`
rm -rf ${test262_dir}
mkdir ${test262_dir}
# Copy over the test262 license.
cp ${tmp_dir}/LICENSE ${test262_dir}
# The test262 tests are in test/suite. The "bestPractice" tests cover non-
# standard extensions, or are not strictly required by specs, so we don't
# include them. The remaining tests are currently in "intl402" or "chNN"
# directories (where NN is an ECMA-262 chapter number). This may change at
# some point, as there is some dissatisfaction on test262-discuss with using
# impermanent section numbering (across ES5, ES6, etc.) to identify what's
# tested.
# The large quantity of tests at issue here, and the variety of things being
# tested, motivate importing portions of test262 incrementally. So rather than
# doing this:
# cp -r ${tmp_dir}/test/suite/ch* ${test262_dir}
# ...we instead individually import folders whose tests we pass. (Well, mostly
# pass -- see the comment at the end of this script.)
cp -r ${tmp_dir}/test/suite/ch06 ${test262_dir}/ch06
cp -r ${tmp_dir}/test/suite/ch07 ${test262_dir}/ch07
cp -r ${tmp_dir}/test/suite/ch08 ${test262_dir}/ch08
cp -r ${tmp_dir}/test/suite/ch09 ${test262_dir}/ch09
cp -r ${tmp_dir}/test/suite/ch10 ${test262_dir}/ch10
cp -r ${tmp_dir}/test/suite/ch11 ${test262_dir}/ch11
cp -r ${tmp_dir}/test/suite/ch12 ${test262_dir}/ch12
cp -r ${tmp_dir}/test/suite/ch13 ${test262_dir}/ch13
cp -r ${tmp_dir}/test/suite/ch14 ${test262_dir}/ch14
# The test402 tests are in test/suite/intl402/. For now there are no
# "bestPractice" tests to omit. The remaining tests are in chNN directories,
# NN referring to chapters of ECMA-402.
# All intl402 tests are runnable, and only a few currently fail, so we import
# them wildcard-style.
mkdir ${test262_dir}/intl402
cp -r ${tmp_dir}/test/suite/intl402/ch* ${test262_dir}/intl402
# Copy over harness supporting files needed by the test402 tests.
cp ${tmp_dir}/test/harness/sta.js ${js_src_tests_dir}/supporting/
cp ${tmp_dir}/test/harness/testBuiltInObject.js ${js_src_tests_dir}/supporting/
cp ${tmp_dir}/test/harness/testIntl.js ${js_src_tests_dir}/supporting/
# Create empty browser.js and shell.js in all test directories to keep
# jstests happy.
for dir in `find ${test262_dir} ${test262_dir}/ch* ${test262_dir}/intl402/ch* -type d -print` ; do
touch $dir/browser.js
touch $dir/shell.js
# Construct the test262 tests' jstests adapter files.
cp ${js_src_tests_dir}/supporting/test262-browser.js ${test262_dir}/browser.js
cat ${js_src_tests_dir}/supporting/sta.js ${js_src_tests_dir}/supporting/test262-shell.js > ${test262_dir}/shell.js
# Restore the Intl tests' jstests adapter files. Loading include files into the
# browser from a script so that they become synchronously available to that same
# script is basically impossible. Instead, just concatenate all the scripts
# together into one script loaded before the test executes.
cat ${js_src_tests_dir}/supporting/test402-browser.js \
${js_src_tests_dir}/supporting/testBuiltInObject.js \
${js_src_tests_dir}/supporting/testIntl.js > ${test262_dir}/intl402/browser.js
cp ${js_src_tests_dir}/supporting/test402-shell.js ${test262_dir}/intl402/shell.js
# Keep a record of what we imported.
echo "URL: $1" > ${test262_dir}/HG-INFO
hg -R ${tmp_dir} log -r. >> ${test262_dir}/HG-INFO
# Update for the patch.
hg addremove ${js_src_tests_dir}/supporting
hg addremove ${test262_dir}
# Apply a very narrow set of post-fixes to tests that haven't yet been updated
# for spec changes, or where we're experimenting with semantics that disagree
# with those in test262. See below: this isn't every test we don't pass!
patch -d "${js_src_tests_dir}" -p4 < ./function-arguments-caller-changes.diff
patch -d "${js_src_tests_dir}" -p4 < ./dupl-prop-changes.diff
# The alert reader may now be wondering: what about test262 tests that we don't
# pass? (And what about any test262 tests whose format we don't yet support?)
# We explicitly disable all such tests in js/src/tests/jstests.list one by one.
# This has the moderate benefit that if a bug is fixed, only that one file must
# be updated, and we don't have to rerun this script.