Link a document’s alternate language version.
HTML: Use hreflang on an alternate link to declare the language of another page.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Example</title>
<link rel="alternate" hreflang="fr" href="https://example.com/fr/guide">
</head>
<body>
<h1>English guide</h1>
</body>
</html>Expected output EXAMPLE
The document identifies https://example.com/fr/guide as its French alternate. The link metadata does not translate the current page or navigate automatically.
Details
Save as example.html and open in a modern browser. The output describes browser behavior verified with DOM and interaction assertions. Use hreflang on an alternate link to declare the language of another page.
The browser test verifies the published metadata declaration. Search engines and external preview services decide how to use it.
Tested on Ubuntu 24.04.5 LTS · · Chromium 141.0.7390.37 · libc6 2.39-0ubuntu8.9; Playwright 1.56.0
Test inputs, results and environment
The exact published code ran in a dedicated Linux test container with prepared inputs. Unprivileged snippet process, external networking disabled, read-only root filesystem, and a fresh temporary working directory. Fixtures and output records are isolated from the application database. Testing covers this example and its stated checks, not every input, operating system, or runtime version. The Linux container shares its host's kernel; this is not a native Windows test.
- Architecture / host kernel
- x86_64 / 6.18.54.1-microsoft-standard-WSL2
- Snippet identity / locale
- uid=65534, gid=65534 (unprivileged) / C.UTF-8
- Interpreter invocation
Chromium: open example.html; execute the published browser assertions- Container image ID
sha256:32dc2d998158b6554c99b73b533f423696a0f3e31e8cbea9db10b5eee9a2fadd- Code SHA-256
5ddcacdc5971b7141cff2384469836f7e93f7e18f468fa277c57ccb84e5c2271- Dependencies
- libc6 2.39-0ubuntu8.9; Playwright 1.56.0
Test input setup
These are the prepared inputs used by the test harness. See Details above for the prerequisites and how to run this example.
# No input files required.
Observed standard output
Expected output describes the rendered page. The standard-output record below is the browser test harness receipt; the additional assertions check the result and interactions.
Link a document’s alternate language version: browser checks passed.
Exit code: 0. Standard error: empty. Validation: Shape/content assertions. System-dependent values above are one recorded run.
Additional assertions that passed
Checks recorded by the test harness. Where Python assertions are shown, browser cases use Playwright and simulator cases may inspect pin transitions: result.stdout is captured output, work is the temporary directory, and Path is pathlib.Path. The harness also imports json and csv.
assert await page.locator('link[rel=alternate]').get_attribute('hreflang')=='fr'
assert await page.locator('link[rel=alternate]').evaluate('(e)=>e.href')=='https://example.com/fr/guide'