# SPDX-License-Identifier: GPL-3.0-or-later """ Common fixtures for Haketilo unit tests """ # This file is part of Haketilo. # # Copyright (C) 2021 Wojtek Kosior <koszko@koszko.org> # # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program. If not, see <https://www.gnu.org/licenses/>. # # I, Wojtek Kosior, thereby promise not to sue for violation of this file's # license. Although I request that you do not make use this code in a # proprietary program, I am not going to enforce this in court. import pytest from ..profiles import firefox_safe_mode from ..server import do_an_internet from ..script_loader import load_script @pytest.fixture(scope="package") def proxy(): httpd = do_an_internet() yield httpd httpd.shutdown() @pytest.fixture(scope="package") def driver(proxy): with firefox_safe_mode() as driver: yield driver driver.quit() script_injecting_script = '''\ /* * Selenium by default executes scripts in some weird one-time context. We want * separately-loaded scripts to be able to access global variables defined * before, including those declared with `const` or `let`. To achieve that, we * run our scripts by injecting them into the page inside a <script> tag. We use * custom properties of the `window` object to communicate with injected code. */ const script_elem = document.createElement('script'); script_elem.textContent = arguments[0]; delete window.haketilo_selenium_return_value; delete window.haketilo_selenium_exception; window.returnval = (val => window.haketilo_selenium_return_value = val); window.arguments = arguments[1]; document.body.append(script_elem); /* * To ease debugging, we want this script to forward signal all exceptions from * the injectee. */ try { if (window.haketilo_selenium_exception !== false) throw 'Error in injected script! Check your geckodriver.log!'; } finally { script_elem.remove(); } return window.haketilo_selenium_return_value; ''' def _execute_in_page_context(driver, script, *args): script = script + '\n;\nwindow.haketilo_selenium_exception = false;' try: return driver.execute_script(script_injecting_script, script, args) except Exception as e: import sys lines = enumerate(script.split('\n'), 1) for err_info in [('Failing script\n',), *lines]: print(*err_info, file=sys.stderr) raise e from None @pytest.fixture(scope="package") def execute_in_page(driver): def do_execute(script, *args, **kwargs): if 'page' in kwargs: driver.get(kwargs['page']) return _execute_in_page_context(driver, script, args) yield do_execute @pytest.fixture(scope="package") def load_into_page(driver): def do_load(path, import_dirs, *args, **kwargs): if 'page' in kwargs: driver.get(kwargs['page']) _execute_in_page_context(driver, load_script(path, import_dirs), args) yield do_load