{"id":15164310,"url":"https://github.com/io-digital/gore","last_synced_at":"2025-09-30T19:30:40.569Z","repository":{"id":57252507,"uuid":"93566369","full_name":"io-digital/gore","owner":"io-digital","description":"test web applications using a headless chrome instance","archived":true,"fork":false,"pushed_at":"2017-06-12T08:42:09.000Z","size":81,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-18T21:12:44.890Z","etag":null,"topics":["browser-testing","chrome","chrome-headless","chrome-instance","devtools-domains","node","test","test-runner"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/io-digital.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-06T21:41:48.000Z","updated_at":"2023-01-28T21:13:25.000Z","dependencies_parsed_at":"2022-08-31T22:20:32.103Z","dependency_job_id":null,"html_url":"https://github.com/io-digital/gore","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io-digital%2Fgore","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io-digital%2Fgore/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io-digital%2Fgore/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/io-digital%2Fgore/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/io-digital","download_url":"https://codeload.github.com/io-digital/gore/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234767159,"owners_count":18883391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-testing","chrome","chrome-headless","chrome-instance","devtools-domains","node","test","test-runner"],"created_at":"2024-09-27T03:04:05.877Z","updated_at":"2025-09-30T19:30:35.294Z","avatar_url":"https://github.com/io-digital.png","language":"JavaScript","readme":"\n# gore\n\ngore is a simple and mostly unfinished chrome headless test runner using a slightly monkey-patched [chrome-remote-interface](https://npmjs.org/package/chrome-remote-interface) as the mechanism for controlling the chrome instance.\n\nthe test runner is page navigation oriented, meaning that each test case is made up of discrete steps (just async functions) that interact with the page in some way.\n\nevery step in a test case besides the final one is allowed to return `boolean`, `string` and `undefined` values allowing you to pass or fail a test early, navigate to a new page, or declare that navigation occurred manually, respectively. the final step of a test is required to return a `boolean` value to indicate the outcome.\n\neach test case and its constituent steps are executed sequentially.\n\n## example\n\n```javascript\n(async function() {\n  var gore = require('gore')\n  var {suite, runtime} = await gore()\n  suite([{\n    description: 'run a google search',\n    start_at: 'http://google.com',\n    steps: [\n      async function() {\n        await runtime.eval(function() {\n          var search_box = document.querySelector('#lst-ib')\n          search_box.value = 'kitties'\n          search_box.form.submit() // submit the form to trigger a page navigation\n                                   // which causes the next step to be executed\n        })\n        // return nothing (undefined) from this step to\n        // indicate that page navigation was implicit\n      },\n      async function() {\n        var title = await runtime.eval(function() {\n          return document.title\n        })\n        var number_of_results = await runtime.eval(function() {\n          return document.querySelectorAll('.g').length\n        })\n        return ( // return a boolean to indicate the test outcome\n          title === 'kitties - Google Search' \u0026\u0026\n          number_of_results === 10\n        )\n      }\n    ]\n  }])\n})()\n```\n\n## todo\n\n* [ ] the test runner will use chrome canary by default if it is installed\n* [ ] better/more documentation\n* [ ] investigate `SystemInfo` domain\n* [ ] add more devtools domains and abstractions\n* [ ] add more testing runtime statistics and feedback\n* [ ] description strings for test steps\n* [ ] tests\n* [ ] contribution guidelines\n* [ ] write weird test cases to learn and improve the limits of the test runner\n* [ ] write examples using more devtools domains\n* [ ] [screenshot capture](https://medium.com/@dschnr/using-headless-chrome-as-an-automated-screenshot-tool-4b07dffba79a)\n* [ ] test case parallelism using multiple chrome instances/tabs?\n* [ ] before/after(all) hooks\n* [ ] machine readable output formats\n\n## legal\n\n\"Google\" and \"Google Chrome\" are trademarks held by Alphabet Inc. i am in no way affiliated with these companies and/or their projects.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fio-digital%2Fgore","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fio-digital%2Fgore","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fio-digital%2Fgore/lists"}