From 363292644c504033b35b1dfff1342c35f17d66f4 Mon Sep 17 00:00:00 2001 From: Yuchen Pei Date: Wed, 8 Dec 2021 21:28:04 +1100 Subject: Added a script that checks a url for compliance in the command line. Also added copyright and license header to the headless test script. --- README | 28 +++++++++++++++++++++++++--- 1 file changed, 25 insertions(+), 3 deletions(-) (limited to 'README') diff --git a/README b/README index f67f5fc..14a2d83 100644 --- a/README +++ b/README @@ -37,9 +37,12 @@ is loaded as a "temporary add-on" from about:debugging. Otherwise (if included in the xpi, see BUILD above) it can be launched from the UI by clicking the [Automated self test...] button. -To launch the test in command line, ensure the extension has been -built with automated test suite. Then install selenium-webdriver and -geckodriver, and ensure the latter is in $PATH: + +HEADLESS TESTS: + +To launch the test suite from the command line, ensure the extension +has been built with automated test suite. Then install +selenium-webdriver and geckodriver, and ensure the latter is in $PATH: $ npm install selenium-webdriver $ npm install geckodriver @@ -56,6 +59,25 @@ Optionally you can also test with a chosen seed $ node ./test.js 12345 +HEADLESS COMPLIANCE CHECK: + +To check whether a webpage is LibreJS-compliant from the command line, ensure that the extension has NOT been built with automated test suite. Then install selenium-webdriver and geckodriver, and ensure the latter is in $PATH: + + $ npm install selenium-webdriver + $ npm install geckodriver + $ export PATH=$PATH:./node_modules/.bin + +Now you can check a webpage for compliance with + + $ node ./compliance.js + +It will open the url in a headless browser, save a screenshot, and output the compliance check result. + +For example, to check the compliance of the FSF homepage, do + + $ node ./compliance.js https://fsf.org + + CONTACT: Development mailing list: bug-librejs@gnu.org -- cgit v1.2.3