Super-simple tool for dynamically setting the favicon image on a page.
Last updated 7 years ago by henrikjoreteg .
Repository · Original npm · Tarball · package.json
$ cnpm install favicon-setter 
SYNC missed versions from official npm registry.


Super simple util for setting the favicon of a page:

  • No dependencies
  • Only works in browsers that let you dynamically set favicons: FF, Opera, Chrome
  • Is exported as CommonJS for those who like that <3
  • Becomes a jQuery plugin if not commonJS and jquery is on the page
  • Else add a setFavicon function to the window

How to use it:

Step 1. include it:

<script src="favicon-setter.js"></script>

Step 2. Set your favicon like so:

window.setFavicon('/new-url.png'); // should be 16x16 image (pngs are best)

That's it!

CommonJS Version

If you're using this on the client but your project is in node.js you can install this with: https://github.com/henrikjoreteg/clientmodules and npm.

var setFavicon = require('favicon-setter');



If you've got jquery on the page, insert this after including jQuery.


Restoring the original

Just one other little trick. If the original favicon was set by using a <link rel="shortcut icon"> tag then you can restore the original after setting it by calling setFavicon() without any arguments.


Props to @mathias for this: https://gist.github.com/428626 which served as starting point for this code.



If you like this, follow @HenrikJoreteg on the twitterwebz.

Current Tags

  • 0.1.1                                ...           latest (7 years ago)

3 Versions

  • 0.1.1                                ...           7 years ago
  • 0.1.0                                ...           7 years ago
  • 0.0.1                                ...           8 years ago
Maintainers (1)
Today 0
This Week 0
This Month 1
Last Day 0
Last Week 0
Last Month 3
Dependencies (0)
Dev Dependencies (0)

Copyright 2014 - 2016 © taobao.org |