selenium-api-tests

Shared Selenium tests that verify both moving parts of the 51Degrees cloud:

• the cloud under development against the stable API examples, and
• each API under development against the stable public cloud (https://cloud.51degrees.com/).

It is not a submodule. The cloud repo and each API repo check this repo out as a sibling directory and run it at their integration-test step.

Test categories

Category	What it checks	Where it runs
Contract	An example app serves 51Degrees.core.js, client-side evidence flows back, and the server-rendered page shows a real detection result.	Cloud CI (per example, vs :8080) and every API CI (vs the public cloud).
CloudInternal	Cloud response behaviour through a browser: cache reuse, COEP/CORP headers, third-party cookies, client-side overrides, and the per-browser JS endpoints.	Cloud CI only (vs :8080).

Select a subset with --filter TestCategory=Contract or --filter TestCategory=CloudInternal.

How a run is wired

• Example app — for CI the example is launched by the caller and its URL is passed in EXAMPLE_URL. For local runs set EXAMPLE_LANG (e.g. dotnet) and the suite launches the example from the sibling checkout.
• Cloud endpoint — CLOUD_ROOT_URL is the cloud the example talks to and the cloud the CloudInternal tests hit directly.
• Browser — by default a local Chrome driver is used. Set SELENIUM_URL to use a Selenium grid instead (CI uses a standalone grid).

Configuration

All configuration is read from environment variables — nothing is read from a file, and no keys are committed.

Variable	Used by	Notes
CLOUD_ROOT_URL	all	Base cloud URL, e.g. https://cloud.51degrees.com/.
PAID_RESOURCE_KEY	all	Resource key used by the tests.
FREE_RESOURCE_KEY	CloudInternal	Free resource key for the JS-endpoint tests.
ENTERPRISE_V4_LICENSE	CloudInternal	License passed to the JS endpoint to unlock paid properties.
SELENIUM_URL	optional	Selenium grid URL; omit for a local Chrome driver.
EXAMPLE_URL / EXAMPLE_LANG	Contract	The example app to test (CI / local).

A missing variable only fails the test that reads it.

Running locally

Contract against the public cloud, dotnet example from the sibling checkout:

export CLOUD_ROOT_URL="https://cloud.51degrees.com/"
export PAID_RESOURCE_KEY="<your paid resource key>"
export EXAMPLE_LANG="dotnet"
dotnet test --filter TestCategory=Contract

CloudInternal against a cloud you control:

export CLOUD_ROOT_URL="http://localhost:8080/"
export FREE_RESOURCE_KEY="<free key>"
export PAID_RESOURCE_KEY="<paid key>"
export ENTERPRISE_V4_LICENSE="<license>"
dotnet test --filter TestCategory=CloudInternal

CI integration

• Cloud CI checks this repo out as ../selenium-api-tests, builds it once, runs Contract per example against the local :8080 container, and runs CloudInternal once against :8080.
• Each API CI checks this repo out, launches its own example, and runs Contract against the public cloud.