Added: more spec_anchors

Author: mnot

tests/age-parse.mjs

@@ -9,6 +9,7 @@ export default
     {
       name: 'HTTP cache should ignore an `Age` header with a non-numeric value',
       id: 'age-parse-nonnumeric',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -28,6 +29,7 @@ export default
     {
       name: 'HTTP cache should ignore an `Age` header with a negative value',
       id: 'age-parse-negative',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -47,6 +49,7 @@ export default
     {
       name: 'HTTP cache should ignore an `Age` header with a float value',
       id: 'age-parse-float',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -66,6 +69,7 @@ export default
     {
       name: 'HTTP cache should consider a response with a `Age` value of 2147483647 to be stale',
       id: 'age-parse-large-minus-one',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -85,6 +89,7 @@ export default
     {
       name: 'HTTP cache should consider a response with a `Age` value of 2147483648 to be stale',
       id: 'age-parse-large',
+      spec_anchors: ['delta-seconds'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -104,6 +109,7 @@ export default
     {
       name: 'HTTP cache should consider a response with a `Age` value of 2147483649 to be stale',
       id: 'age-parse-larger',
+      spec_anchors: ['delta-seconds'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -123,6 +129,7 @@ export default
     {
       name: 'HTTP cache should consider a response with a single `Age` header line `old, 0` to be stale',
       id: 'age-parse-suffix',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -142,6 +149,7 @@ export default
     {
       name: 'HTTP cache should consider a response with a single `Age` header line `0, old` to be fresh',
       id: 'age-parse-prefix',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -161,6 +169,7 @@ export default
     {
       name: 'HTTP cache should use the first line in a response with multiple `Age` header lines: `old`, `0`',
       id: 'age-parse-suffix-twoline',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -181,6 +190,7 @@ export default
     {
       name: 'HTTP cache should use the first line in a response with multiple `Age` header lines: `0`, `old`',
       id: 'age-parse-prefix-twoline',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -201,6 +211,7 @@ export default
     {
       name: 'HTTP cache should consider a response with a single line `Age: 0, 0` to be fresh',
       id: 'age-parse-dup-0',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -220,6 +231,7 @@ export default
     {
       name: 'HTTP cache should consider a response with two `Age: 0` header lines to be fresh',
       id: 'age-parse-dup-0-twoline',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {
@@ -240,6 +252,7 @@ export default
     {
       name: 'HTTP cache should consider a response with two `Age: not_old` header lines to be fresh',
       id: 'age-parse-dup-old',
+      spec_anchors: ['field.age'],
       depends_on: ['freshness-max-age-age'],
       requests: [
         {

tests/authorization.mjs

@@ -11,6 +11,7 @@ export default
     {
       name: 'HTTP shared cache must not reuse a response to a request that contained `Authorization`, even with explicit freshness',
       id: 'other-authorization',
+      spec_anchors: ['caching.authenticated.responses'],
       depends_on: ['freshness-max-age'],
       browser_skip: true,
       requests: [

tests/cc-parse.mjs

@@ -102,6 +102,7 @@ export default
       name: 'HTTP cache must not reuse a response with `max-age` in a quoted string (before the "real" `max-age`)',
       id: 'freshness-max-age-ignore-quoted',
       depends_on: ['freshness-max-age'],
+      spec_anchors: ['cache-response-directive.max-age'],
       requests: [
         {
           response_headers: [
@@ -119,6 +120,7 @@ export default
       name: 'HTTP cache mut not reuse a response with `max-age` in a quoted string (after the "real" `max-age`)',
       id: 'freshness-max-age-ignore-quoted-rev',
       depends_on: ['freshness-max-age'],
+      spec_anchors: ['cache-response-directive.max-age'],
       requests: [
         {
           response_headers: [
@@ -171,6 +173,7 @@ export default
     {
       name: 'An optimal HTTP cache reuses max-age with the value `003600`',
       id: 'freshness-max-age-leading-zero',
+      spec_anchors: ['delta-seconds'],
       depends_on: ['freshness-none'],
       requests: [
         {
@@ -189,6 +192,7 @@ export default
       name: 'HTTP cache must not reuse a response with a single-quoted `Cache-Control: max-age`',
       id: 'freshness-max-age-single-quoted',
       depends_on: ['freshness-none'],
+      spec_anchors: ['cache-response-directive.max-age'],
       requests: [
         {
           response_headers: [

tests/cc-response.mjs

@@ -354,6 +354,7 @@ export default
     {
       name: 'A HTTP cache MUST revalidate a stale response with `Cache-Control: immutable`',
       id: 'cc-resp-immutable-stale',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc8246.html#section-2'],
       browser_only: true,
       requests: [
         {

tests/cdn-cache-control.mjs

@@ -65,6 +65,7 @@ export default
     {
       name: 'CDN must not reuse a response when the `Age` header is greater than its `CDN-Cache-Control: max-age` freshness lifetime',
       id: 'cdn-max-age-age',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       cdn_only: true,
       depends_on: ['cdn-max-age'],
       requests: [
@@ -125,6 +126,7 @@ export default
     {
       name: 'CDN must not reuse a response with `CDN-Cache-Control: max-age=0`',
       id: 'cdn-max-age-0',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       cdn_only: true,
       depends_on: ['cdn-max-age'],
       requests: [
@@ -224,6 +226,7 @@ export default
     {
       name: 'CDN must not reuse a response with a `CDN-Cache-Control: max-age=0` and a future `Expires`',
       id: 'cdn-max-age-0-expires',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       cdn_only: true,
       depends_on: ['cdn-max-age'],
       requests: [
@@ -264,6 +267,7 @@ export default
     {
       name: 'CDN must prefer a short `CDN-Cache-Control: max-age` over a long `Cache-Control: max-age`',
       id: 'cdn-max-age-long-cc-max-age',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       cdn_only: true,
       depends_on: ['cdn-max-age'],
       requests: [
@@ -283,6 +287,7 @@ export default
     {
       name: 'CDN must not reuse a cached response with `CDN-Cache-Control: private`, even with `Cache-Control: max-age` and `Expires`',
       id: 'cdn-private',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       cdn_only: true,
       requests: [
         {
@@ -302,6 +307,7 @@ export default
     {
       name: 'CDN must not reuse a cached response with `CDN-Cache-Control: no-cache`, even with `Cache-Control: max-age` and `Expires`',
       id: 'cdn-no-cache',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       cdn_only: true,
       requests: [
         {
@@ -321,6 +327,7 @@ export default
     {
       name: 'CDN must not store a response with `CDN-Cache-Control: no-store`, even with `Cache-Control: max-age` and `Expires`',
       id: 'cdn-no-store-cc-fresh',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       cdn_only: true,
       depends_on: ['freshness-none'],
       requests: [
@@ -342,6 +349,7 @@ export default
     {
       name: 'An optimal CDN stores a response with a fresh `CDN-Cache-Control: max-age`, even with `Cache-Control: no-store`',
       id: 'cdn-fresh-cc-nostore',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       depends_on: ['freshness-none'],
       cdn_only: true,
       requests: [
@@ -361,6 +369,7 @@ export default
     {
       name: 'CDN should ignore a `CDN-Cache-Control` that\'s an invalid Structured Field (unknown type)',
       id: 'cdn-cc-invalid-sh-type-unknown',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       depends_on: ['cdn-max-age'],
       cdn_only: true,
       requests: [
@@ -380,6 +389,7 @@ export default
     {
       name: 'CDN should ignore a `CDN-Cache-Control` that\'s an invalid Structured Field (wrong type)',
       id: 'cdn-cc-invalid-sh-type-wrong',
+      spec_anchors: ['https://www.rfc-editor.org/rfc/rfc9213.html'],
       depends_on: ['cdn-max-age'],
       cdn_only: true,
       requests: [

tests/conditional-etag.mjs

@@ -30,6 +30,7 @@ export default {
     {
       name: 'HTTP cache must include `ETag` in a `304 Not Modified`',
       id: 'conditional-304-etag',
+      spec_anchors: ['freshening.responses'],
       depends_on: ['conditional-etag-strong-respond'],
       browser_skip: true,
       requests: [
@@ -53,6 +54,7 @@ export default {
     {
       name: 'HTTP cache must give precedence to `If-None-Match` over `If-Modified-Since`',
       id: 'conditional-etag-precedence',
+      spec_anchors: ['validation.received'],
       depends_on: ['conditional-etag-strong-respond'],
       browser_skip: true,
       requests: [
@@ -310,6 +312,7 @@ export default {
     {
       name: 'HTTP cache must include stored response headers identified by `Vary` in a conditional request it generates',
       id: 'conditional-etag-vary-headers',
+      spec_anchors: ['validation.sent'],
       requests: [
         {
           request_headers: [
@@ -339,6 +342,7 @@ export default {
     {
       name: 'HTTP cache must not use a stored `ETag` to validate when the presented `Vary`ing request header differs',
       id: 'conditional-etag-vary-headers-mismatch',
+      spec_anchors: ['caching.negotiated.responses'],
       depends_on: ['conditional-etag-vary-headers', 'vary-no-match'],
       requests: [
         {

tests/expires-freshness.mjs

@@ -28,6 +28,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with a past `Expires`',
       id: 'freshness-expires-past',
+      spec_anchors: ['calculating.freshness.lifetime'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -46,6 +47,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with a present `Expires`',
       id: 'freshness-expires-present',
+      spec_anchors: ['calculating.freshness.lifetime'],
       depends_on: ['freshness-none'],
       requests: [
         {
@@ -63,6 +65,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an `Expires` older than `Date`, both fast',
       id: 'freshness-expires-old-date',
+      spec_anchors: ['calculating.freshness.lifetime'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -81,6 +84,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (0)',
       id: 'freshness-expires-invalid',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -117,6 +121,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response when the `Age` header is greater than its `Expires` minus `Date`, and `Date` is slow',
       id: 'freshness-expires-age-slow-date',
+      spec_anchors: ['calculating.freshness.lifetime'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -135,6 +140,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response when the `Age` header is greater than its `Expires` minus `Date`, and `Date` is fast',
       id: 'freshness-expires-age-fast-date',
+      spec_anchors: ['calculating.freshness.lifetime'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {

tests/expires-parse.mjs

@@ -142,6 +142,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (UTC)',
       id: 'freshness-expires-invalid-utc',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -160,6 +161,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (other tz)',
       id: 'freshness-expires-invalid-aest',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -178,6 +180,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (two-digit year)',
       id: 'freshness-expires-invalid-2-digit-year',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -196,6 +199,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (missing comma)',
       id: 'freshness-expires-invalid-no-comma',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -214,6 +218,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (multiple spaces)',
       id: 'freshness-expires-invalid-multiple-spaces',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -231,6 +236,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (date dashes)',
       id: 'freshness-expires-invalid-date-dashes',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -248,6 +254,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (time periods)',
       id: 'freshness-expires-invalid-time-periods',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -265,6 +272,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (1-digit hour)',
       id: 'freshness-expires-invalid-1-digit-hour',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {
@@ -282,6 +290,7 @@ export default
     {
       name: 'HTTP cache must not reuse a response with an invalid `Expires` (multiple lines)',
       id: 'freshness-expires-invalid-multiple-lines',
+      spec_anchors: ['field.expires'],
       depends_on: ['freshness-expires-future'],
       requests: [
         {

tests/headers.mjs

@@ -7,6 +7,7 @@ const tests = []
 tests.push({
   name: '`Connection` header must inhibit a HTTP cache from storing listed headers',
   id: 'headers-omit-headers-listed-in-Connection',
+  spec_anchors: ['storing.fields'],
   kind: 'required',
   depends_on: ['freshness-max-age'],
   requests: [
@@ -46,6 +47,7 @@ function checkStoreHeader (config) {
   tests.push({
     name: `HTTP cache ${requirement} store \`${config.name}\` header field`,
     id: `headers-${id}`,
+    spec_anchors: ['storing.fields'],
     kind: 'required',
     depends_on: ['freshness-max-age'],
     requests: [