{"_id":"@astridhq/fetch-favicon","_rev":"1-fcf030c501ed23eb27e939ad6f5da474","name":"@astridhq/fetch-favicon","dist-tags":{"latest":"0.0.4-rc.3"},"versions":{"0.0.4-rc.3":{"name":"@astridhq/fetch-favicon","version":"0.0.4-rc.3","description":"Fetch a great looking favicon from a website","main":"dist/index.js","scripts":{"test":"gulp","lint":"gulp lint","test-browser":"gulp test-browser","watch":"gulp watch","build":"gulp build","coverage":"gulp coverage","semantic-release":"semantic-release pre && npm publish && semantic-release post","prepublishOnly":"npm run build"},"repository":{"type":"git","url":"git+https://github.com/astridhq/fetch-favicon.git"},"keywords":["favicon","logo","icon","ico"],"author":{"name":"Meltwater"},"license":"MIT","bugs":{"url":"https://github.com/astridhq/fetch-favicon/issues"},"homepage":"https://github.com/astridhq/fetch-favicon","devDependencies":{"babel-core":"^6.3.26","babel-eslint":"6.0.0","babel-loader":"^6.2.0","babel-polyfill":"^6.3.14","babel-preset-es2015":"^6.3.13","babel-register":"^6.3.13","chai":"^3.4.1","commitizen":"^2.7.3","condition-circle":"^1.2.0","cz-conventional-changelog":"^1.1.5","del":"^2.2.0","eslint-config-standard":"5.1.0","eslint-plugin-promise":"1.1.0","eslint-plugin-standard":"1.3.2","glob":"^6.0.3","gulp":"^3.9.0","gulp-babel":"^6.1.1","gulp-eslint":"2.0.0","gulp-filter":"^3.0.0","gulp-istanbul":"^0.10.3","gulp-jscs":"^3.0.0","gulp-livereload":"^3.8.1","gulp-load-plugins":"^1.1.0","gulp-mocha":"^2.2.0","gulp-plumber":"^1.0.1","gulp-rename":"^1.2.2","gulp-sourcemaps":"^1.6.0","gulp-uglify":"^1.5.1","gulp-util":"^3.0.7","isparta":"^4.0.0","json-loader":"^0.5.3","mocha":"^2.3.4","nock":"^7.7.2","semantic-release":"^4.3.5","sinon":"^1.17.2","sinon-chai":"^2.8.0","webpack":"^1.12.9","webpack-node-externals":"^1.0.0","webpack-stream":"^3.1.0"},"babelBoilerplateOptions":{"entryFileName":"index","mainVarName":"fetchFavicon"},"config":{"commitizen":{"path":"./node_modules/cz-conventional-changelog"}},"release":{"verifyConditions":"condition-circle"},"dependencies":{"x-ray":"^2.2.0"},"directories":{"test":"test"},"gitHead":"ebfc55b2402a47bbb1c44b9c5a6bc342691ef913","_id":"@astridhq/fetch-favicon@0.0.4-rc.3","_npmVersion":"6.4.1","_nodeVersion":"8.16.0","_npmUser":{"name":"perjonsson","email":"per.d.jonsson@gmail.com"},"dist":{"integrity":"sha512-lnYWiT0rnsOHNpN+5Xffd1Lx5Oo5gbVWO6dLyOR4/uP9NtEa66bB6hKkjM01VR1rcZNPzYZR/mp9UrOZKQno6w==","shasum":"b4edb32c2d2e5f18cab3e0d54387f949ad4fefc7","tarball":"https://registry.npmjs.org/@astridhq/fetch-favicon/-/fetch-favicon-0.0.4-rc.3.tgz","fileCount":41,"unpackedSize":290005,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfT2ZlCRA9TVsSAnZWagAAYW8P/1yz6CIUyO+FbSXXusWu\nlzG2OXfLoSpRmzm4rB/t0T3fFpnR75ZOkmAlt1q5ze2wnB5/JJwjgk6h9WGL\nlCJcaKhO/nIEpR0vlDK+srl85edfgY2ivpqT5IrUVWhr2LHU7Vq5p2cM03st\nmb3oCRdQLMUlFyhBtXw5A1Sitfaefpm8teH/poYLwNCmnQnc51Sva86UBheH\nNX+ete1+36pXUEqfbabjX9htUNx17n+zCNTuqRwnDNjEQv1sXueJuhYA4HbE\nJ8OZKTuJ9XNcnXfIKOX1xrhYJj6wRaXXHNDqMk7zqi1/4tZRAVS0u06qqCAt\nnqNpbziwoXl95qdNBDpWD55m+wqZVJVhA2m26qPPkhjDZ1Ow/DqT5ZOW/1pM\nDjlFs26QuZ7quHvwKC2Q4EvLXWBTghKMq7VEtW7f6u2X8/kajtNcQfMRymOB\nPxHCvnFk06czzaU92/xiuRDbO77dWDs5kEHoeVG18QJuYyDbuPFlmfmrdQIF\nplaf0JIXWoUkvm544XnvRmQCeT+NFUuyNstVtV9S54nNZs/E7BtG4MTJJvmR\nvfj1Vem/7xaH/DqoaPjcqE+U1UDLgK5rNe+6XhG2Wei4HKJvH5nXTbKXkzyp\ntUXYPXQ3dqJsxMReKqIjOjWD9oHfO4vXE2r005qtUapEygb1IQWLw0BuzHVS\neCO1\r\n=nMQ2\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIC5flFZ5Bw3HqUYpaf+Y9mJvx2UmwwMMdH54E9FGAG/gAiEAuFuS1ecLc5FrDaI3mzXNAjcvvnM7VYBnd6zZ7Ngiq1c="}]},"maintainers":[{"name":"perjonsson","email":"per.d.jonsson@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fetch-favicon_0.0.4-rc.3_1599039076808_0.9554753509778886"},"_hasShrinkwrap":false}},"time":{"created":"2020-09-02T09:31:16.548Z","0.0.4-rc.3":"2020-09-02T09:31:16.976Z","modified":"2022-04-04T15:54:22.135Z"},"maintainers":[{"name":"perjonsson","email":"per.d.jonsson@gmail.com"}],"description":"Fetch a great looking favicon from a website","homepage":"https://github.com/astridhq/fetch-favicon","keywords":["favicon","logo","icon","ico"],"repository":{"type":"git","url":"git+https://github.com/astridhq/fetch-favicon.git"},"author":{"name":"Meltwater"},"bugs":{"url":"https://github.com/astridhq/fetch-favicon/issues"},"license":"MIT","readme":"# ![fetch-favicon](/img/logo.png)\n\n[![Circle CI](https://circleci.com/gh/meltwater/fetch-favicon.svg?style=svg&circle-token=58431fbfc2ecc57479f4b9255afb806ccff83c6b)](https://circleci.com/gh/meltwater/fetch-favicon)\n[![Dependency Status](https://david-dm.org/meltwater/fetch-favicon.svg)](https://david-dm.org/meltwater/fetch-favicon)\n[![devDependency Status](https://david-dm.org/meltwater/fetch-favicon/dev-status.svg)](https://david-dm.org/meltwater/fetch-favicon#info=devDependencies)\n[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com)\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n[![npm version](https://badge.fury.io/js/%40meltwater%2Ffetch-favicon.svg)](https://badge.fury.io/js/%40meltwater%2Ffetch-favicon)\n\nFavicons can be difficult. They come in several different formats, no page seems to have them all, and it is hard to know which one to use when you want the best. `fetch-favicon` takes the complexity out by finding them all and choosing the best for you.\n\n## Installation\n\n```\nnpm install @meltwater/fetch-favicon --save\n```\n\n## Using fetch-favicon\n### getFavicon(url, [size])\n\n```javascript\n// using an ES6 transpiler, like babel\nimport fetchFavicon from '@meltwater/fetch-favicon'\n\n// not using an ES6 transpiler\nvar fetchFavicon = require('@meltwater/fetch-favicon').fetchFavicon\n\nfetchFavicon('https://www.github.com')\n\n/*\n'https://github.com/apple-touch-icon.png'\n*/\n```\n#### Arguments\n- __url:__ the address of the web page to be searched for favicons\n- __size:__ _(optional)_ an integer that represents a prefered minimum width/height of the favicon. If none of the retrieved favicons meet this constraint or the size information is not available, fetch-favicon will still return a favicon.\n\n- __returns:__ the address of a favicons. If no favicons are found it will return the address of the `favicon.ico` off of the root (i.e. `https://www.github.com/favicon.ico`)\n\n### getFavicons(url, [size])\n\n```javascript\n// using an ES6 transpiler, like babel\nimport { fetchFavicons } from '@meltwater/fetch-favicon'\n\n// not using an ES6 transpiler\nvar fetchFavicons = require('@meltwater/fetch-favicon').fetchFavicons\n\nfetchFavicons('https://www.github.com')\n\n/*\n[\n  {\"href\":\"http://github.com/apple-touch-icon.png\",\"name\":\"apple-touch-icon\"},\n  {\"href\":\"http://github.com/apple-touch-icon-57x57.png\",\"name\":\"apple-touch-icon\",\"size\":57,\"active\":true},\n  {\"href\":\"http://github.com/apple-touch-icon-60x60.png\",\"name\":\"apple-touch-icon\",\"size\":60},\n  {\"href\":\"http://github.com/apple-touch-icon-72x72.png\",\"name\":\"apple-touch-icon\",\"size\":72},\n  {\"href\":\"http://github.com/apple-touch-icon-76x76.png\",\"name\":\"apple-touch-icon\",\"size\":76},\n  {\"href\":\"http://github.com/apple-touch-icon-114x114.png\",\"name\":\"apple-touch-icon\",\"size\":114},\n  {\"href\":\"http://github.com/apple-touch-icon-120x120.png\",\"name\":\"apple-touch-icon\",\"size\":120},\n  {\"href\":\"http://github.com/apple-touch-icon-144x144.png\",\"name\":\"apple-touch-icon\",\"size\":144},\n  {\"href\":\"http://github.com/apple-touch-icon-152x152.png\",\"name\":\"apple-touch-icon\",\"size\":152},\n  {\"href\":\"http://github.com/apple-touch-icon-180x180.png\",\"name\":\"apple-touch-icon\",\"size\":180},\n  {\"href\":\"https://assets-cdn.github.com/images/modules/open_graph/github-logo.png\",\"name\":\"og:image\"},\n  {\"href\":\"https://assets-cdn.github.com/images/modules/open_graph/github-mark.png\",\"name\":\"og:image\"},\n  {\"href\":\"https://assets-cdn.github.com/images/modules/open_graph/github-octocat.png\",\"name\":\"og:image\"},\n  {\"href\":\"/windows-tile.png\",\"name\":\"msapplication-TileImage\"},\n  {\"href\":\"https://assets-cdn.github.com/favicon.ico\",\"name\":\"icon\"},\n  {\"href\":\"http://github.com/favicon.ico\",\"name\":\"favicon.ico\"}\n]\n*/\n```\n#### Arguments\n- __url:__ the address of the web page to be searched for favicons\n- __size:__ _(optional)_ an integer that represents a prefered minimum width/height of the favicon.\n\n- __returns:__ an array of all the favicons found on the web page.\n  - _href:_ _(string)_ location of the favicon image\n  - _name:_ _(string)_ type of favicon\n  - _size:_ _(int)_ size of favicon (if available)\n  - _active:_ _(bool)_ `true` for the favicon returned by `getFavicon`. `undefined` for all others.\n\n## Contributing\n\n#### Code Conventions\nUse [standard](http://standardjs.com/). CI won't pass without it.\n\n#### Tests\nAdd tests where appropriate. See the test [readme](/test/unit/readme.md) for some suggestions.\n\n#### Semantic Versioning\nFormat commit messages to conform to [conventional-changelog](https://github.com/ajoslin/conventional-changelog). This drives the semantic versioning of the module.\n\n## Additional Information\n\n- [favicon-cheat-sheet](https://github.com/audreyr/favicon-cheat-sheet) is a great resource for understanding all the idiosyncrasies of favicons.\n\n## License\n\nMIT\n","readmeFilename":"readme.md"}