http-specs, test case on status code range

.chronus/changes/http-specs_error-code-range-2025-0-13-14-28-49.md

@@ -0,0 +1,7 @@
+---
+changeKind: feature
+packages:
+  - "@typespec/http-specs"
+---
+
+Add test case on status code range

packages/http-specs/spec-summary.md

@@ -1679,9 +1679,7 @@ Two requests need to be tested.
     { "id": "1", "name": "dog" },
     { "id": "2", "name": "cat" }
   ],
-  "links": {
-    "next": "http://[host]:[port]/payload/pageable/server-driven-pagination/link/nextPage"
-  }
+  "next": "http://[host]:[port]/payload/pageable/server-driven-pagination/link/nextPage"
 }
 ```
 
@@ -2084,6 +2082,23 @@ Expected request body:
 </SimpleModel>
 ```
 
+### Response_StatusCodeRange_errorResponse
+
+- Endpoint: `get /response/status-code-range/error-response`
+
+Test case for range of status code in error response.
+
+Verify that the result of the API is an error/exception in client, and the error response can be de-serialized to ErrorInRange model (instead of DefaultError model).
+
+Expected status code 494 and response body:
+
+```json
+{
+  "code": "request-header-too-large",
+  "message": "Request header too large"
+}
+```
+
 ### Routes_fixed
 
 - Endpoint: `get /routes/fixed`

packages/http-specs/specs/response/status-code-range/main.tsp

@@ -0,0 +1,45 @@
+import "@typespec/http";
+import "@typespec/spector";
+
+using Http;
+using Spector;
+
+/**
+ * Test for range of status code.
+ */
+@scenarioService("/response/status-code-range")
+namespace Response.StatusCodeRange;
+
+@scenario
+@scenarioDoc("""
+  Test case for range of status code in error response.
+
+  Verify that the result of the API is an error/exception in client, and the error response can be de-serialized to ErrorInRange model (instead of DefaultError model).
+
+  Expected status code 494 and response body:
+  ```json
+  { 
+    "code": "request-header-too-large",
+    "message": "Request header too large"
+  }
+  ```
+  """)
+@route("/error-response")
+@get
+op errorResponse(): 204 | ErrorInRange | DefaultError;
+
+@error
+model ErrorInRange {
+  @minValue(494)
+  @maxValue(499)
+  @statusCode
+  _: int32;
+
+  code: string;
+  message: string;
+}
+
+@error
+model DefaultError {
+  code: string;
+}

packages/http-specs/specs/response/status-code-range/mockapi.ts

@@ -0,0 +1,19 @@
+import { json, passOnSuccess, ScenarioMockApi } from "@typespec/spec-api";
+
+export const Scenarios: Record<string, ScenarioMockApi> = {};
+
+Scenarios.Response_StatusCodeRange_errorResponse = passOnSuccess({
+  uri: "/response/status-code-range/error-response",
+  method: "get",
+  request: {
+    status: 494,
+  },
+  response: {
+    status: 494,
+    body: json({
+      code: "request-header-too-large",
+      message: "Request header too large",
+    }),
+  },
+  kind: "MockApiDefinition",
+});