@guardian/libs NPM | npm.io

19.1.0 • Published 8 months ago

Install

Weekly downloads

229

License

-

Repository

Last release

8 months 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.

Consent

The Guardian's consent management platform.

Cookies

API over document.cookies.

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.

`isNonNullable`

Check whether a value is a NonNullable.

`isObject`

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

`isOneOf`

Check whether a value is one of a set of literal string or numbers.

`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.

Performance

API over window.performance with hooks into log the data warehouse.

`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';

Bundling

This package uses ES2020.

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

Local Testing Using Linking

In the command line in your terminal, navigate to the csnx root directory. Run:

make @guardian/libs:build

This build command has to be re-run for changes to be picked up.

Navigate to the repo that will test your code changes. In the appropriate folder of that repo, run

npm/yarn/pnpm link ../csnx/dist/libs/@guardian/libs

where '../csnx' is the path to your local changes in csnx where you cloned the csnx code to.

After re-building the '@guardian/libs' in step 1. this command does not have to be repeated and changes will be automatically picked up.

Once you’ve developed your changes and tested, you can unlink from the repo where you are testing the changes

npm/yarn/pnpm unlink ../csnx/dist/libs/@guardian/libs

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

0.0.0-canary-20241029130354

8 months ago

0.0.0-canary-20241022092600

8 months ago

0.0.0-canary-20241022100456

8 months ago

0.0.0-canary-20241016110527

8 months ago

9 months ago

9 months ago

0.0.0-canary-20240911125254

10 months ago

0.0.0-canary-20240911130848

10 months ago

0.0.0-canary-20240813074122

11 months ago

0.0.0-canary-20240701145956

12 months ago

0.0.0-canary-20240619082525

1 year ago

0.0.0-canary-20240701154542

12 months ago

0.0.0-canary-20240619120049

1 year ago

0.0.0-canary-20240701154308

12 months ago

0.0.0-canary-20240911110316

10 months ago

0.0.0-canary-20240620131201

1 year ago

0.0.0-canary-20240911112046

10 months ago

0.0.0-canary-20240624085432

1 year ago

0.0.0-canary-20240829071655

10 months ago

0.0.0-canary-20240717085735

11 months ago

0.0.0-canary-20240819084206

10 months ago

0.0.0-canary-20240620133132

1 year ago

0.0.0-canary-20240610091042

1 year ago

10 months ago

10 months ago

12 months ago

0.0.0-canary-20240812095031

11 months ago

0.0.0-canary-20240620133134

1 year ago

0.0.0-canary-20240729085532

11 months ago

0.0.0-canary-20240911114332

10 months ago

0.0.0-canary-20240618085448

1 year ago

0.0.0-canary-20240909092337

10 months ago

0.0.0-canary-20240917081659

9 months ago

0.0.0-canary-20240606084326

1 year ago

0.0.0-canary-20240701153039

12 months ago

0.0.0-canary-20240911140913

10 months ago

0.0.0-canary-20240701171014

12 months ago

0.0.0-canary-20240911122945

10 months ago

0.0.0-canary-20240829110247

10 months ago

0.0.0-canary-20240911151236

10 months ago

0.0.0-canary-20240902115558

10 months ago

1 year ago

0.0.0-canary-20240618120327

1 year ago

0.0.0-canary-20240605105845

1 year ago

0.0.0-canary-20240827084710

10 months ago

0.0.0-canary-20240619082211

1 year ago

0.0.0-canary-20240911120517

10 months ago

0.0.0-canary-20240619154551

1 year ago

0.0.0-canary-20240902111616

10 months ago

0.0.0-canary-20240605094526

1 year ago

12 months ago

1 year ago

0.0.0-canary-20240702090103

12 months ago

0.0.0-canary-20240619121342

1 year ago

0.0.0-canary-20240917082909

9 months ago

0.0.0-canary-20240813083420

11 months ago

0.0.0-canary-20240702085855

12 months ago

0.0.0-canary-20240702092146

12 months ago

0.0.0-canary-20240701151352

12 months ago

0.0.0-canary-20240619090505

1 year ago

0.0.0-canary-20240715101752

12 months ago

0.0.0-canary-20240912110451

10 months ago

0.0.0-canary-20240620105532

1 year ago

0.0.0-canary-20240620130720

1 year ago

0.0.0-canary-20240829102324

10 months ago

0.0.0-canary-20240618071438

1 year ago

0.0.0-canary-20240515080035

1 year ago

0.0.0-canary-20240515085843

1 year ago

0.0.0-canary-20240515080039

1 year ago

0.0.0-canary-20240515133404

1 year ago

0.0.0-canary-20240515082018

1 year ago

0.0.0-canary-20240515085554

1 year ago

0.0.0-canary-20240513095011

1 year ago

0.0.0-canary-20240513110200

1 year ago

1 year ago

0.0.0-canary-20240508123120

1 year ago

0.0.0-canary-20240507160332

1 year ago

0.0.0-canary-20240507155911

1 year ago

0.0.0-canary-20240502224620

1 year ago

1 year ago

0.0.0-canary-20240502162806

1 year ago

0.0.0-canary-20240502163620

1 year ago

0.0.0-canary-20240502084749

1 year ago

0.0.0-canary-20240501082641

1 year ago

0.0.0-canary-20240430182345

1 year ago

0.0.0-canary-20240430073821

1 year ago

0.0.0-canary-20240430075045

1 year ago

0.0.0-canary-20240430105413

1 year ago

0.0.0-canary-20240501120742

1 year ago

0.0.0-canary-20240430122501

1 year ago

0.0.0-canary-20240430123957

1 year ago

0.0.0-canary-20240430122003

1 year ago

0.0.0-canary-20240430084025

1 year ago

0.0.0-canary-20240430103434

1 year ago

0.0.0-canary-20240501142053

1 year ago

0.0.0-canary-20240430085225

1 year ago

0.0.0-canary-20240429155350

1 year ago

0.0.0-canary-20240429082722

1 year ago

0.0.0-canary-20240429145541

1 year ago

0.0.0-canary-20240429095626

1 year ago

0.0.0-canary-20240429115029

1 year ago

0.0.0-canary-20240429145342

1 year ago

0.0.0-canary-20240429065822

1 year ago

0.0.0-canary-20240426120243

1 year ago

1 year ago

0.0.0-canary-20240425161913

1 year ago

0.0.0-canary-20240425164837

1 year ago

0.0.0-canary-20240422135349

1 year ago

0.0.0-canary-20240422140456

1 year ago

1 year ago

0.0.0-canary-20240325210020

1 year ago

0.0.0-canary-20240321122831

1 year ago

0.0.0-canary-20240314102721

1 year ago

0.0.0-canary-20240312112226

1 year ago

0.0.0-canary-20240312105146

1 year ago

0.0.0-canary-20240312100301

1 year ago

0.0.0-canary-20240308155628

1 year ago

0.0.0-canary-20240208113652

1 year ago

0.0.0-canary-20240208113827

1 year ago

0.0.0-canary-20240208114409

1 year ago

0.0.0-canary-20240207181240

1 year ago

0.0.0-beta-20240207172123

1 year ago

0.0.0-canary-20240207185219

1 year ago

0.0.0-canary-20240207183159

1 year ago

0.0.0-beta-20240207171606

1 year ago

0.0.0-beta-20240207173947

1 year ago

0.0.0-beta-20240207170044

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

3 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

2 years ago

3 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

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

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago

5 years ago