gravatar-url
TypeScript icon, indicating that this package has built-in type declarations

4.0.1 • Public • Published

gravatar-url

Get the URL to a Gravatar image from an identifier, such as an email

Install

$ npm install gravatar-url

Usage

import gravatarUrl from 'gravatar-url';

gravatarUrl('sindresorhus@gmail.com', {size: 200});
//=> 'https://gravatar.com/avatar/d36a92237c75c5337c17b60d90686bf9?size=200'

API

gravatarUrl(identifier, options?)

identifier

Type: string

Identifier for which to get the Gravatar image.

This will typically be an email matching a Gravatar profile, but can technically be any string.

The Gravatar service only sees a hash of the identifier, so you could actually use this to get pseudo-random avatars for any entity, e.g. based on its ID.

Note that if the identifier contains an @, it is assumed to be an email, and will therefore be lower-cased and trimmed before hashing, as per the Gravatar instructions - otherwise it will be hashed as-is.

options

Type: object

size

Type: number
Default: 80
Values: 1..2048

Size of the image.

default

Type: string
Default: This image
Values: Custom URL or 404, mm, identicon, monsterid, wavatar, retro, blank

Image to return if the identifier didn't match any Gravatar profile.

rating

Type: string
Default: g
Values: g pg r x

Allowed rating of the image.

Related

Package Sidebar

Install

npm i gravatar-url

Weekly Downloads

17,681

Version

4.0.1

License

MIT

Unpacked Size

6.82 kB

Total Files

5

Last publish

Collaborators

  • sindresorhus