2019-09-04 21:10:23 +02:00
|
|
|
import assert from 'assert'
|
|
|
|
import nock from 'nock'
|
|
|
|
import sinon from 'sinon'
|
|
|
|
import proxyquire from 'proxyquire'
|
|
|
|
|
2020-11-24 16:38:04 +01:00
|
|
|
const fakeStorage = {}
|
2019-09-04 21:10:23 +02:00
|
|
|
const fetchWithCache = proxyquire('./fetch-with-cache', {
|
2020-11-24 16:38:04 +01:00
|
|
|
'../../../lib/storage-helpers': fakeStorage,
|
2019-09-04 21:10:23 +02:00
|
|
|
}).default
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
describe('Fetch with cache', function () {
|
|
|
|
beforeEach(function () {
|
2020-11-24 16:38:04 +01:00
|
|
|
fakeStorage.getStorageItem = sinon.stub()
|
|
|
|
fakeStorage.setStorageItem = sinon.stub()
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
2020-02-11 17:51:13 +01:00
|
|
|
afterEach(function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
sinon.restore()
|
|
|
|
nock.cleanAll()
|
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('fetches a url', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/price')
|
|
|
|
.reply(200, '{"average": 1}')
|
|
|
|
|
2020-11-03 00:41:28 +01:00
|
|
|
const response = await fetchWithCache(
|
|
|
|
'https://fetchwithcache.metamask.io/price',
|
|
|
|
)
|
2020-12-03 16:46:22 +01:00
|
|
|
assert.deepStrictEqual(response, {
|
2019-09-04 21:10:23 +02:00
|
|
|
average: 1,
|
|
|
|
})
|
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('returns cached response', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/price')
|
|
|
|
.reply(200, '{"average": 2}')
|
|
|
|
|
2020-11-24 16:38:04 +01:00
|
|
|
fakeStorage.getStorageItem.returns({
|
Fix `fetch-with-cache` handling of interwoven requests (#10079)
A data race was introduced in #9919 when the old synchronous storage
API was replaced with an async storage API. The problem arises when
`fetchWithCache` is called a second time while it's still processing
another call. In this case, the `cachedFetch` object can become
stale while blocked waiting for a fetch response, and result in a cache
being overwritten unintentionally.
See this example (options omitted for simplicity, and assuming an empty
initial cache):
```
await Promise.all([
fetchWithCache('https://metamask.io/foo'),
fetchWithCache('https://metamask.io/bar'),
]
```
The order of events could be as follows:
1. Empty cache retrieved for `/foo` route
2. Empty cache retrieved for `/bar` route
3. Call made to `/foo` route
4. Call made to `/bar` route
5. `/foo` response is added to the empty cache object retrieved in
step 1, then is saved in the cache.
6. `/bar` response is added to the empty cache object retrieved in
step 2, then is saved in the cache.
In step 6, the cache object saved would not contain the `/foo`
response set in step 5. As a result, `/foo` would never be cached.
This problem was resolved by embedding the URL being cached directly in
the cache key. This prevents simultaneous responses from overwriting
each others caches.
Technically a data race still exists when handing simultaneous
responses to the same route, but the result would be that the last call
to finish would overwrite the previous. This seems acceptable.
2020-12-15 21:21:13 +01:00
|
|
|
cachedResponse: { average: 1 },
|
|
|
|
cachedTime: Date.now(),
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
|
|
|
|
2020-11-03 00:41:28 +01:00
|
|
|
const response = await fetchWithCache(
|
|
|
|
'https://fetchwithcache.metamask.io/price',
|
|
|
|
)
|
2020-12-03 16:46:22 +01:00
|
|
|
assert.deepStrictEqual(response, {
|
2019-09-04 21:10:23 +02:00
|
|
|
average: 1,
|
|
|
|
})
|
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('fetches URL again after cache refresh time has passed', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/price')
|
|
|
|
.reply(200, '{"average": 3}')
|
|
|
|
|
2020-11-24 16:38:04 +01:00
|
|
|
fakeStorage.getStorageItem.returns({
|
Fix `fetch-with-cache` handling of interwoven requests (#10079)
A data race was introduced in #9919 when the old synchronous storage
API was replaced with an async storage API. The problem arises when
`fetchWithCache` is called a second time while it's still processing
another call. In this case, the `cachedFetch` object can become
stale while blocked waiting for a fetch response, and result in a cache
being overwritten unintentionally.
See this example (options omitted for simplicity, and assuming an empty
initial cache):
```
await Promise.all([
fetchWithCache('https://metamask.io/foo'),
fetchWithCache('https://metamask.io/bar'),
]
```
The order of events could be as follows:
1. Empty cache retrieved for `/foo` route
2. Empty cache retrieved for `/bar` route
3. Call made to `/foo` route
4. Call made to `/bar` route
5. `/foo` response is added to the empty cache object retrieved in
step 1, then is saved in the cache.
6. `/bar` response is added to the empty cache object retrieved in
step 2, then is saved in the cache.
In step 6, the cache object saved would not contain the `/foo`
response set in step 5. As a result, `/foo` would never be cached.
This problem was resolved by embedding the URL being cached directly in
the cache key. This prevents simultaneous responses from overwriting
each others caches.
Technically a data race still exists when handing simultaneous
responses to the same route, but the result would be that the last call
to finish would overwrite the previous. This seems acceptable.
2020-12-15 21:21:13 +01:00
|
|
|
cachedResponse: { average: 1 },
|
|
|
|
cachedTime: Date.now() - 1000,
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
|
|
|
|
2020-11-03 00:41:28 +01:00
|
|
|
const response = await fetchWithCache(
|
|
|
|
'https://fetchwithcache.metamask.io/price',
|
|
|
|
{},
|
|
|
|
{ cacheRefreshTime: 123 },
|
|
|
|
)
|
2020-12-03 16:46:22 +01:00
|
|
|
assert.deepStrictEqual(response, {
|
2019-09-04 21:10:23 +02:00
|
|
|
average: 3,
|
|
|
|
})
|
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('should abort the request when the custom timeout is hit', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/price')
|
|
|
|
.delay(100)
|
|
|
|
.reply(200, '{"average": 4}')
|
|
|
|
|
2020-04-14 17:33:33 +02:00
|
|
|
await assert.rejects(
|
2020-11-03 00:41:28 +01:00
|
|
|
() =>
|
|
|
|
fetchWithCache(
|
|
|
|
'https://fetchwithcache.metamask.io/price',
|
|
|
|
{},
|
|
|
|
{ timeout: 20 },
|
|
|
|
),
|
2020-04-14 17:33:33 +02:00
|
|
|
{ name: 'AbortError', message: 'Aborted' },
|
|
|
|
)
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('throws when the response is unsuccessful', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/price')
|
|
|
|
.reply(500, '{"average": 6}')
|
|
|
|
|
2020-11-03 00:41:28 +01:00
|
|
|
await assert.rejects(() =>
|
|
|
|
fetchWithCache('https://fetchwithcache.metamask.io/price'),
|
2020-04-14 17:33:33 +02:00
|
|
|
)
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('throws when a POST request is attempted', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.post('/price')
|
|
|
|
.reply(200, '{"average": 7}')
|
|
|
|
|
2020-11-03 00:41:28 +01:00
|
|
|
await assert.rejects(() =>
|
|
|
|
fetchWithCache('https://fetchwithcache.metamask.io/price', {
|
|
|
|
method: 'POST',
|
|
|
|
}),
|
2020-04-14 17:33:33 +02:00
|
|
|
)
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('throws when the request has a truthy body', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/price')
|
|
|
|
.reply(200, '{"average": 8}')
|
|
|
|
|
2020-11-03 00:41:28 +01:00
|
|
|
await assert.rejects(() =>
|
|
|
|
fetchWithCache('https://fetchwithcache.metamask.io/price', { body: 1 }),
|
2020-04-14 17:33:33 +02:00
|
|
|
)
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
|
|
|
|
2020-02-11 17:51:13 +01:00
|
|
|
it('throws when the request has an invalid Content-Type header', async function () {
|
2019-09-04 21:10:23 +02:00
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/price')
|
|
|
|
.reply(200, '{"average": 9}')
|
|
|
|
|
2020-04-14 17:33:33 +02:00
|
|
|
await assert.rejects(
|
2020-11-03 00:41:28 +01:00
|
|
|
() =>
|
|
|
|
fetchWithCache('https://fetchwithcache.metamask.io/price', {
|
|
|
|
headers: { 'Content-Type': 'text/plain' },
|
|
|
|
}),
|
2020-04-14 17:33:33 +02:00
|
|
|
{ message: 'fetchWithCache only supports JSON responses' },
|
|
|
|
)
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|
Fix `fetch-with-cache` handling of interwoven requests (#10079)
A data race was introduced in #9919 when the old synchronous storage
API was replaced with an async storage API. The problem arises when
`fetchWithCache` is called a second time while it's still processing
another call. In this case, the `cachedFetch` object can become
stale while blocked waiting for a fetch response, and result in a cache
being overwritten unintentionally.
See this example (options omitted for simplicity, and assuming an empty
initial cache):
```
await Promise.all([
fetchWithCache('https://metamask.io/foo'),
fetchWithCache('https://metamask.io/bar'),
]
```
The order of events could be as follows:
1. Empty cache retrieved for `/foo` route
2. Empty cache retrieved for `/bar` route
3. Call made to `/foo` route
4. Call made to `/bar` route
5. `/foo` response is added to the empty cache object retrieved in
step 1, then is saved in the cache.
6. `/bar` response is added to the empty cache object retrieved in
step 2, then is saved in the cache.
In step 6, the cache object saved would not contain the `/foo`
response set in step 5. As a result, `/foo` would never be cached.
This problem was resolved by embedding the URL being cached directly in
the cache key. This prevents simultaneous responses from overwriting
each others caches.
Technically a data race still exists when handing simultaneous
responses to the same route, but the result would be that the last call
to finish would overwrite the previous. This seems acceptable.
2020-12-15 21:21:13 +01:00
|
|
|
|
|
|
|
it('should correctly cache responses from interwoven requests', async function () {
|
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/foo')
|
|
|
|
.reply(200, '{"average": 9}')
|
|
|
|
nock('https://fetchwithcache.metamask.io')
|
|
|
|
.get('/bar')
|
|
|
|
.reply(200, '{"average": 9}')
|
|
|
|
|
|
|
|
const testCache = {}
|
|
|
|
fakeStorage.getStorageItem.callsFake((key) => testCache[key])
|
|
|
|
fakeStorage.setStorageItem.callsFake((key, value) => {
|
|
|
|
testCache[key] = value
|
|
|
|
})
|
|
|
|
|
|
|
|
await Promise.all([
|
|
|
|
fetchWithCache(
|
|
|
|
'https://fetchwithcache.metamask.io/foo',
|
|
|
|
{},
|
|
|
|
{ cacheRefreshTime: 123 },
|
|
|
|
),
|
|
|
|
fetchWithCache(
|
|
|
|
'https://fetchwithcache.metamask.io/bar',
|
|
|
|
{},
|
|
|
|
{ cacheRefreshTime: 123 },
|
|
|
|
),
|
|
|
|
])
|
|
|
|
|
|
|
|
assert.deepStrictEqual(
|
|
|
|
testCache['cachedFetch:https://fetchwithcache.metamask.io/foo']
|
|
|
|
.cachedResponse,
|
|
|
|
{ average: 9 },
|
|
|
|
)
|
|
|
|
assert.deepStrictEqual(
|
|
|
|
testCache['cachedFetch:https://fetchwithcache.metamask.io/bar']
|
|
|
|
.cachedResponse,
|
|
|
|
{ average: 9 },
|
|
|
|
)
|
|
|
|
})
|
2019-09-04 21:10:23 +02:00
|
|
|
})
|