1 | /*!
|
---|
2 | * fresh
|
---|
3 | * Copyright(c) 2012 TJ Holowaychuk
|
---|
4 | * Copyright(c) 2016-2017 Douglas Christopher Wilson
|
---|
5 | * MIT Licensed
|
---|
6 | */
|
---|
7 |
|
---|
8 | 'use strict'
|
---|
9 |
|
---|
10 | /**
|
---|
11 | * RegExp to check for no-cache token in Cache-Control.
|
---|
12 | * @private
|
---|
13 | */
|
---|
14 |
|
---|
15 | var CACHE_CONTROL_NO_CACHE_REGEXP = /(?:^|,)\s*?no-cache\s*?(?:,|$)/
|
---|
16 |
|
---|
17 | /**
|
---|
18 | * Module exports.
|
---|
19 | * @public
|
---|
20 | */
|
---|
21 |
|
---|
22 | module.exports = fresh
|
---|
23 |
|
---|
24 | /**
|
---|
25 | * Check freshness of the response using request and response headers.
|
---|
26 | *
|
---|
27 | * @param {Object} reqHeaders
|
---|
28 | * @param {Object} resHeaders
|
---|
29 | * @return {Boolean}
|
---|
30 | * @public
|
---|
31 | */
|
---|
32 |
|
---|
33 | function fresh (reqHeaders, resHeaders) {
|
---|
34 | // fields
|
---|
35 | var modifiedSince = reqHeaders['if-modified-since']
|
---|
36 | var noneMatch = reqHeaders['if-none-match']
|
---|
37 |
|
---|
38 | // unconditional request
|
---|
39 | if (!modifiedSince && !noneMatch) {
|
---|
40 | return false
|
---|
41 | }
|
---|
42 |
|
---|
43 | // Always return stale when Cache-Control: no-cache
|
---|
44 | // to support end-to-end reload requests
|
---|
45 | // https://tools.ietf.org/html/rfc2616#section-14.9.4
|
---|
46 | var cacheControl = reqHeaders['cache-control']
|
---|
47 | if (cacheControl && CACHE_CONTROL_NO_CACHE_REGEXP.test(cacheControl)) {
|
---|
48 | return false
|
---|
49 | }
|
---|
50 |
|
---|
51 | // if-none-match
|
---|
52 | if (noneMatch && noneMatch !== '*') {
|
---|
53 | var etag = resHeaders['etag']
|
---|
54 |
|
---|
55 | if (!etag) {
|
---|
56 | return false
|
---|
57 | }
|
---|
58 |
|
---|
59 | var etagStale = true
|
---|
60 | var matches = parseTokenList(noneMatch)
|
---|
61 | for (var i = 0; i < matches.length; i++) {
|
---|
62 | var match = matches[i]
|
---|
63 | if (match === etag || match === 'W/' + etag || 'W/' + match === etag) {
|
---|
64 | etagStale = false
|
---|
65 | break
|
---|
66 | }
|
---|
67 | }
|
---|
68 |
|
---|
69 | if (etagStale) {
|
---|
70 | return false
|
---|
71 | }
|
---|
72 | }
|
---|
73 |
|
---|
74 | // if-modified-since
|
---|
75 | if (modifiedSince) {
|
---|
76 | var lastModified = resHeaders['last-modified']
|
---|
77 | var modifiedStale = !lastModified || !(parseHttpDate(lastModified) <= parseHttpDate(modifiedSince))
|
---|
78 |
|
---|
79 | if (modifiedStale) {
|
---|
80 | return false
|
---|
81 | }
|
---|
82 | }
|
---|
83 |
|
---|
84 | return true
|
---|
85 | }
|
---|
86 |
|
---|
87 | /**
|
---|
88 | * Parse an HTTP Date into a number.
|
---|
89 | *
|
---|
90 | * @param {string} date
|
---|
91 | * @private
|
---|
92 | */
|
---|
93 |
|
---|
94 | function parseHttpDate (date) {
|
---|
95 | var timestamp = date && Date.parse(date)
|
---|
96 |
|
---|
97 | // istanbul ignore next: guard against date.js Date.parse patching
|
---|
98 | return typeof timestamp === 'number'
|
---|
99 | ? timestamp
|
---|
100 | : NaN
|
---|
101 | }
|
---|
102 |
|
---|
103 | /**
|
---|
104 | * Parse a HTTP token list.
|
---|
105 | *
|
---|
106 | * @param {string} str
|
---|
107 | * @private
|
---|
108 | */
|
---|
109 |
|
---|
110 | function parseTokenList (str) {
|
---|
111 | var end = 0
|
---|
112 | var list = []
|
---|
113 | var start = 0
|
---|
114 |
|
---|
115 | // gather tokens
|
---|
116 | for (var i = 0, len = str.length; i < len; i++) {
|
---|
117 | switch (str.charCodeAt(i)) {
|
---|
118 | case 0x20: /* */
|
---|
119 | if (start === end) {
|
---|
120 | start = end = i + 1
|
---|
121 | }
|
---|
122 | break
|
---|
123 | case 0x2c: /* , */
|
---|
124 | list.push(str.substring(start, end))
|
---|
125 | start = end = i + 1
|
---|
126 | break
|
---|
127 | default:
|
---|
128 | end = i + 1
|
---|
129 | break
|
---|
130 | }
|
---|
131 | }
|
---|
132 |
|
---|
133 | // final token
|
---|
134 | list.push(str.substring(start, end))
|
---|
135 |
|
---|
136 | return list
|
---|
137 | }
|
---|