{"id":14978841,"url":"https://github.com/teamcfadvance/cfselenium","last_synced_at":"2025-10-28T13:31:22.557Z","repository":{"id":56080035,"uuid":"1382417","full_name":"teamcfadvance/CFSelenium","owner":"teamcfadvance","description":"A native Selenium WebDriver binding for ColdFusion","archived":false,"fork":false,"pushed_at":"2020-11-26T16:29:49.000Z","size":239353,"stargazers_count":82,"open_issues_count":7,"forks_count":32,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-02-01T15:11:31.528Z","etag":null,"topics":["cfc","cfml","coldfusion","lucee","railo","selenium","selenium-webdriver"],"latest_commit_sha":null,"homepage":"","language":"ColdFusion","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teamcfadvance.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":"2011-02-18T12:52:47.000Z","updated_at":"2024-11-12T19:16:45.000Z","dependencies_parsed_at":"2022-08-15T12:50:12.131Z","dependency_job_id":null,"html_url":"https://github.com/teamcfadvance/CFSelenium","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamcfadvance%2FCFSelenium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamcfadvance%2FCFSelenium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamcfadvance%2FCFSelenium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamcfadvance%2FCFSelenium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teamcfadvance","download_url":"https://codeload.github.com/teamcfadvance/CFSelenium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238654976,"owners_count":19508533,"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":["cfc","cfml","coldfusion","lucee","railo","selenium","selenium-webdriver"],"created_at":"2024-09-24T13:58:30.698Z","updated_at":"2025-10-28T13:31:20.265Z","avatar_url":"https://github.com/teamcfadvance.png","language":"ColdFusion","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/teamcfadvance/CFSelenium.svg?branch=master)](https://travis-ci.org/teamcfadvance/CFSelenium)\n\n[CFSelenium](http://github.com/teamcfadvance/CFSelenium) - A Native CFML (ColdFusion) Client Library for the [Selenium WebDriver](http://www.seleniumhq.org/)\n=============================================================================================================\n\n### What is CFSelenium? ###\n\nCFSelenium is a ColdFusion Component (CFC) which provides a native client library for the Selenium WebDriver. This allows you to write tests, using CFML, which will drive a browser and verify results.\n\nThis version has dropped support for Selenium-RC and Selenium-IDE. Also the tests have been rewritten for [TestBox](https://www.ortussolutions.com/products/testbox) by [Ortus Solutions](https://www.ortussolutions.com/).\n\n### Requirements ###\n\n1. [Lucee 4.5+](http://lucee.org/) or [Adobe ColdFusion 11+](http://www.coldfusion.com)\n2. [TestBox](https://www.ortussolutions.com/products/testbox) if you want to run the test suite\n\n### Implementation ###\n\nEnsure that the standalone Selenium Server jar file is in your Java load path. You can add this to your Application.cfc to ensure the file is loaded.\n\n    this.javaSettings = { loadPaths = [ '/path/to/cfselenium/lib/selenium-server-standalone-3.4.0.jar' ] };\n\nTo create an instance of Selenium WebDriver:\n\n\tselenium = new cfselenium.SeleniumWebDriver( driverType=\"firefox\", webDriver=\"path/to/webdrivers/webDriverFilename\" );\n\nwhere webDriverFilename is the binary for the platform you are running. See the example in tests/specs/firefoxSpec.cfc\n\nCurrently the Firefox WebDrivers for both Macintosh and Windows are provided. Other browsers and operating systems will be added as test coverage increases.\n\n##### Using WebDriver\n\nExample: Get a page title.\n\n```\nselenium = new cfselenium.SeleniumWebDriver( driverType=\"firefox\", webDriver=\"path/to/webdrivers/webDriverFilename\" );\ndriver = selenium.getDriver();\ndriver.get( \"https://www.google.com\" );\nwritedump( var=\"#driver.getTitle()#\" ); // evaluates to \"Google\"\ndriver.quit();\n```\n\n### Testing ###\n\n#### Running the Tests\n\n```\ncd /path/to/my/webroot/ # or wherever you want to put stuff\ngit clone https://github.com/teamcfadvance/CFSelenium.git cfselenium\ncd cfselenium\ngit checkout master\ngit clone https://github.com/Ortus-Solutions/TestBox.git testbox\ncd testbox\ngit checkout master\n```\n\n##### Multi-CFML-Engine Testing using CommandBox\n\nOne super-easy way to do tests in different CFML engines is this is to install [CommandBox](https://www.ortussolutions.com/products/commandbox) by [Ortus Solutions](https://www.ortussolutions.com/) , run the executable, then, within CommandBox:\n\n```\ncd /path/to/my/webroot/ # or wherever you'd put it\n# testing in Lucee 4.5, for instance\nserver start cfengine=lucee@4.5 # when done testing, run `stop`\n# testing in ACF 11, for instance\nserver start cfengine=adobe@11 # when done testing, run `stop`\n```\n\nThat will open a browser window with a random port (e.g., 62261), after which, browse to the following to run the tests and see the results:\n\n* Functional tests:\n\t* WebDriver: http://localhost:62261/cfselenium/tests/\n\n### Support ###\n\nPlease use the main repo's [issue tracker](https://github.com/teamcfadvance/CFSelenium/issues) to report bugs and request enhancements.\n\n### Credits ###\n\nThe script-based version of CFSelenium was created by [Bob Silverberg](https://github.com/bobsilverberg) and the tag-based version was created by by [Brian Swartzfager](https://github.com/bcswartz). [Marc Esher](https://github.com/marcesher) provided the logic which starts and stops the Selenium-RC server automatically. [@Lampei](https://github.com/Lampei) and [Jamie Jackson](https://github.com/jamiejackson) added WebDriver support.\n\n[Richard Herbert](https://github.com/richardherbert) refactored the WebDriver approach and removed support for Selenium-RC and Selenium-IDE. The tests were rewritten using TestBox/CommandBox and MXUnit has been removed.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamcfadvance%2Fcfselenium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteamcfadvance%2Fcfselenium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamcfadvance%2Fcfselenium/lists"}