serve-favicon2.5.0 • Public • Published
Node.js middleware for serving a favicon.
A favicon is a visual cue that client software, like browsers, use to identify a site. For an example and more information, please visit the Wikipedia article on favicons.
Why use this module?
- User agents request
favicon.icofrequently and indiscriminately, so you may wish to exclude these requests from your logs by using this middleware before your logger middleware.
- This module caches the icon in memory to improve performance by skipping disk access.
- This module provides an
ETagbased on the contents of the icon, rather than file system properties.
- This module will serve with the most compatible
Note This module is exclusively for serving the "default, implicit favicon",
GET /favicon.ico. For additional vendor-specific icons that require
HTML markup, additional middleware is required to serve the relevant files, for
$ npm install serve-favicon
Create new middleware to serve a favicon from the given
path to a favicon file.
path may also be a
Buffer of the icon to serve.
Serve favicon accepts these properties in the options object.
max-age directive in
ms, defaulting to 1 year. This can
also be a string accepted by the ms
Typically this middleware will come very early in your stack (maybe even first)
to avoid processing any other middleware if we already know the request is for
var express =var favicon =var path =var app =app// Add your routes here, etc.app
var connect =var favicon =var path =var app =app// Add your middleware here, etc.app
vanilla http server
This middleware can be used anywhere, even outside express/connect. It takes
var http =var favicon =var finalhandler =var path =var _favicon =var server = httpserver