Handle an unsuccessful HTTP status.

jQuery: fail receives the jqXHR object and exposes its status.

JavaScript example.html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Example</title>
</head>
<body>
<output aria-live="polite"></output>
<script src="jquery.min.js"></script>
<script>
$.getJSON('/api/error').fail(xhr=> $('output').text('status '+xhr.status));
</script>
</body>
</html>

Expected output EXAMPLE

The output displays “status 503”.

Details

Save as example.html beside jquery.min.js (jQuery 3.5.1). The browser test uses that local library and checks the resulting behavior. fail receives the jqXHR object and exposes its status.

Keep in mind

Serve the page over HTTP with the endpoint shown. The verification container provides a local fixture API; no external service is contacted.

✓ Verified

Tested on Ubuntu 24.04.5 LTS · · Chromium 141.0.7390.37 · libc6 2.39-0ubuntu8.9; Playwright 1.56.0; jQuery 3.5.1

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. HTTP examples use a same-origin loopback fixture API inside this container. 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
9076d4534978e5e5bff8a1350c68dae81c48cb145db85764fcf08f726ed0f3d2
Dependencies
libc6 2.39-0ubuntu8.9; Playwright 1.56.0; jQuery 3.5.1

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.

Handle an unsuccessful HTTP status: 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.

await page.wait_for_function('document.querySelector("output").textContent === '+'status 503'.__repr__())
assert await page.locator('output').inner_text()=='status 503'