HEAD updates

For #102.

lib/templates.mjs

@@ -22,7 +22,8 @@ export const stale = makeTemplate({
 
 export const becomeStale = makeTemplate({
  response_headers: [
- ['Cache-Control', 'max-age=2']
+ ['Cache-Control', 'max-age=2'],
+ ['Template-A', '1']
  ],
  setup: true,
  pause_after: true

tests/index.mjs

@@ -16,8 +16,9 @@ import conditionalLm from './conditional-lm.mjs'
 import conditionalEtag from './conditional-etag.mjs'
 import headers from './headers.mjs'
 import update304 from './update304.mjs'
+import updateHead from './updateHead.mjs'
 import invalidation from './invalidation.mjs'
 import partial from './partial.mjs'
 import other from './other.mjs'
 
-export default [ccFreshness, ccParse, ageParse, expires, expiresParse, ccResponse, stale, heuristic, methods, statuses, ccRequest, pragma, vary, varyParse, conditionalLm, conditionalEtag, headers, update304, invalidation, partial, other]
+export default [ccFreshness, ccParse, ageParse, expires, expiresParse, ccResponse, stale, heuristic, methods, statuses, ccRequest, pragma, vary, varyParse, conditionalLm, conditionalEtag, headers, update304, updateHead, invalidation, partial, other]

tests/updateHead.mjs

@@ -0,0 +1,108 @@
+
+import * as templates from '../lib/templates.mjs'
+
+export default
+
+{
+ name: 'HEAD updates',
+ id: 'updateHEAD',
+ description: 'HTTP [specifies](https://httpwg.org/http-core/draft-ietf-httpbis-cache-latest.html#head.effects) that `HEAD` responses should update stored responses under certain conditions.',
+ tests: [
+ {
+ name: 'Does HTTP cache write through a HEAD when stored response is stale?',
+ id: 'head-writethrough',
+ kind: 'check',
+ requests: [
+ templates.becomeStale({}),
+ {
+ request_method: 'HEAD',
+ expected_method: 'HEAD'
+ }
+ ]
+ },
+ {
+ name: 'Does HTTP cache preserve stored fields not received in a `200` response to a `HEAD`?',
+ id: 'head-200-retain',
+ kind: 'check',
+ depends_on: ['head-writethrough'],
+ requests: [
+ templates.becomeStale({}),
+ {
+ request_method: 'HEAD',
+ expected_method: 'HEAD',
+ expected_response_headers: [
+ ['Template-A', '1']
+ ]
+ }
+ ]
+ },
+ {
+ name: 'Does HTTP cache update freshness lifetime recieved in a `200` response to a `HEAD`?',
+ id: 'head-200-freshness-update',
+ kind: 'check',
+ depends_on: ['head-writethrough'],
+ requests: [
+ templates.becomeStale({}),
+ {
+ request_method: 'HEAD',
+ expected_method: 'HEAD',
+ response_headers: [
+ ['Cache-Control', 'max-age=1000']
+ ],
+ },
+ {
+ expected_type: 'cached'
+ }
+ ]
+ },
+ {
+ name: 'Does HTTP cache update stored fields recieved in a `200` response to a `HEAD`?',
+ id: 'head-200-update',
+ kind: 'check',
+ depends_on: ['head-writethrough', 'head-200-freshness-update'],
+ requests: [
+ templates.becomeStale({}),
+ {
+ request_method: 'HEAD',
+ expected_method: 'HEAD',
+ response_headers: [
+ ['Template-A', '2'],
+ ['Cache-Control', 'max-age=1000']
+ ],
+ },
+ {
+ expected_type: 'cached',
+ setup_tests: ['expected_type'],
+ expected_response_headers: [
+ ['Template-A', '2']
+ ]
+ }
+ ]
+ },
+ {
+ name: 'Does HTTP cache update stored fields recieved in a `410` response to a `HEAD`?',
+ id: 'head-410-update',
+ kind: 'check',
+ depends_on: ['head-writethrough', 'head-200-freshness-update'],
+ requests: [
+ templates.becomeStale({}),
+ {
+ request_method: 'HEAD',
+ expected_method: 'HEAD',
+ response_status: [410, 'Gone'],
+ response_headers: [
+ ['Template-A', '2'],
+ ['Cache-Control', 'max-age=1000']
+ ],
+ },
+ {
+ expected_type: 'cached',
+ setup_tests: ['expected_type'],
+ expected_response_headers: [
+ ['Template-A', '2']
+ ]
+ }
+ ]
+ }
+ ]
+}