@guardian/libs NPM | npm.io

16.1.3 • Published 3 days ago

Install

Weekly downloads

229

License

-

Repository

Last release

3 days ago

`@guardian/libs`

A collection of JavaScript libraries and TypeScript types for Guardian projects

`ArticleElementRole`

Type that describes the role of an element in an article.

Cookies

API over document.cookies.

Core Web Vitals

API over Google’s web-vitals.

Countries

Country data and methods to access it.

Format

Codified editorial design and information architecture.

Locale

Get the user’s current location.

Switches

Get the active switches on theguardian.com.

`isBoolean`

Check whether a value is a boolean.

`isObject`

Checks whether a value is a plain object (i.e. {}-like).

`isString`

Check whether a value is a string.

`isUndefined`

Check whether a value is undefined.

`joinUrl`

Combines separate url parts into one valid url string.

`loadScript`

Inject an external JavaScript file.

`log`, `debug`

Selectively log team-specific messages to the console.

Ophan

Types relating to Ophan.

`storage`

Robust API over localStorage and sessionStorage.

`timeAgo`

Format absolute dates as time-ago strings.

Installation

yarn add @guardian/libs

or

npm install @guardian/libs

then

import { loadScript, storage, ...etc } from '@guardian/libs';

TypeScript

If you are using this library with TypeScript, make sure you are using at least TypeScript v4.2.2.

Bundling

This package uses ES2020.

If your target environment does not support that, make sure you transpile this package when bundling your application.

Development

Requirements

Node LTS (latest) (nvm or fnm recommended)
Yarn

Releasing

Changes are automatically released to NPM.

The main branch on GitHub is analysed by semantic-release after every push.

If a commit message follows the conventional commit format, semantic-release can determine what Types of changes are included in that commit.

If necessary, it will then automatically release a new, semver-compliant version of the package to NPM.

Pull requests

Try to write PR titles in the conventional commit format, and squash and merge when merging. That way your PR will trigger a release when you merge it (if necessary).

@everything-registry/sub-chunk-378 @guardian/src-accordion @guardian/package-linter @guardian/prebid.js @guardian/src-footer @guardian/src-link @guardian/commercial-bundle @infinitebrahmanuniverse/nolb-_gua

3 days ago

0.0.0-canary-20240508123120

3 days ago

0.0.0-canary-20240507160332

4 days ago

0.0.0-canary-20240507155911

4 days ago

0.0.0-canary-20240502224620

9 days ago

9 days ago

0.0.0-canary-20240502162806

9 days ago

0.0.0-canary-20240502163620

9 days ago

0.0.0-canary-20240502084749

9 days ago

0.0.0-canary-20240501082641

10 days ago

0.0.0-canary-20240430182345

11 days ago

0.0.0-canary-20240430073821

11 days ago

0.0.0-canary-20240430075045

11 days ago

0.0.0-canary-20240430105413

11 days ago

0.0.0-canary-20240501120742

10 days ago

0.0.0-canary-20240430122501

11 days ago

0.0.0-canary-20240430123957

11 days ago

0.0.0-canary-20240430122003

11 days ago

0.0.0-canary-20240430084025

11 days ago

0.0.0-canary-20240430103434

11 days ago

0.0.0-canary-20240501142053

10 days ago

0.0.0-canary-20240430085225

11 days ago

0.0.0-canary-20240429155350

12 days ago

0.0.0-canary-20240429082722

12 days ago

0.0.0-canary-20240429145541

12 days ago

0.0.0-canary-20240429095626

12 days ago

0.0.0-canary-20240429115029

12 days ago

0.0.0-canary-20240429145342

12 days ago

0.0.0-canary-20240429065822

12 days ago

0.0.0-canary-20240426120243

15 days ago

16 days ago

0.0.0-canary-20240425161913

16 days ago

0.0.0-canary-20240425164837

16 days ago

0.0.0-canary-20240422135349

19 days ago

0.0.0-canary-20240422140456

19 days ago

1 month ago

0.0.0-canary-20240325210020

2 months ago

0.0.0-canary-20240321122831

2 months ago

0.0.0-canary-20240314102721

2 months ago

0.0.0-canary-20240312112226

2 months ago

0.0.0-canary-20240312105146

2 months ago

0.0.0-canary-20240312100301

2 months ago

0.0.0-canary-20240308155628

2 months ago

0.0.0-canary-20240208113652

3 months ago

0.0.0-canary-20240208113827

3 months ago

0.0.0-canary-20240208114409

3 months ago

0.0.0-canary-20240207181240

3 months ago

0.0.0-beta-20240207172123

3 months ago

0.0.0-canary-20240207185219

3 months ago

0.0.0-canary-20240207183159

3 months ago

0.0.0-beta-20240207171606

3 months ago

0.0.0-beta-20240207173947

3 months ago

0.0.0-beta-20240207170044

3 months ago

3 months ago

4 months ago

5 months ago

10 months ago

9 months ago

9 months ago

10 months ago

8 months ago

9 months ago

7 months ago

7 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago