cachecontrol

Description:

cachecontrol

cache-control #
Dart only (no dependencies) package to parse and format HTTP Cache-Control header.
Getting started #
$ flutter pub add cachecontrol
copied to clipboard
API #
HTTP requests can have a Cache-Control header for both the request and response header.
Cache-Control: max-age=604800, stale-if-error=86400
copied to clipboard
To parse request headers:
final headers = <String, String>{'Cache-Control': 'max-age=604800, stale-if-error=86400'}
final cacheControl = RequestCacheControl.parse(headers['Cache-Control']!);
copied to clipboard
To parse response headers:
final headers = <String, String>{'Cache-Control': 'max-age=604800, stale-if-error=86400'}
final cacheControl = ResponseCacheControl.parse(headers['Cache-Control']!);
copied to clipboard
Contributing #
Contributions are welcome. Please open up an issue or create PR if you would like to help out.
Make sure to run dart format and dart test before submitting a PR.
FAQ #
Why another cache-control library?
None of the existing libraries focus on just parsing the Cache-Control headers. There are some that expose Express (or connect-like) middlewares, and some unmaintained other ones that do rudimentary parsing of the header. The idea of this module is to parse the header according to the RFC with no further analysis or integration.
See also #

cachecontrol: Golang HTTP Cache-Control Parser and Interpretation
cachecontrol: TypeScript parser and formatter
https://shayy.org/posts/cache-control/
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control
https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching
https://www.mnot.net/cache_docs/
https://jakearchibald.com/2016/caching-best-practices/
https://csswizardry.com/2019/03/cache-control-for-civilians/
https://httpwg.org/specs/rfc9111.html
https://httpwg.org/specs/rfc5861.html
https://httpwg.org/specs/rfc8246.html