https://github.com/continuous-foundation/doi-utils

A toolkit to for handling DOI(Digital Object Identifier)
https://github.com/continuous-foundation/doi-utils

Last synced: about 1 year ago
JSON representation

A toolkit to for handling DOI(Digital Object Identifier)

• Host: GitHub
• URL: https://github.com/continuous-foundation/doi-utils
• Owner: continuous-foundation
• License: mit
• Created: 2022-05-19T18:08:48.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2025-04-04T14:28:04.000Z (about 1 year ago)
• Last Synced: 2025-04-06T19:40:34.097Z (about 1 year ago)
• Language: TypeScript
• Size: 220 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# `doi-utils`

[![doi-utils on npm](https://img.shields.io/npm/v/doi-utils.svg)](https://www.npmjs.com/package/doi-utils)

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/continuous-foundation/doi-utils/blob/master/LICENSE)

![CI](https://github.com/continuous-foundation/doi-utils/actions/workflows/ci.yml/badge.svg)

A small utility for validating, normalizing, and extracting DOIs from text strings.

This repository follows the advice of [CrossRef](https://www.crossref.org/blog/dois-and-matching-regular-expressions/) for regular expression patterns.

> For the 74.9M DOIs we have seen this matches 74.4M of them. If you need to use only one pattern then use this one.

The utility also recognizes URLs that are likely DOIs, and has specific handling for some repositories (e.g. eLife, Zenodo).

## Install

```bash

npm install doi-utils

```

## Overview & Usage

```ts

import { doi } from 'doi-utils';

const isValid = doi.validate('http://doi.org/10.1016/j.cageo.2015.09.015');

doi.buildUrl('http://dx.doi.org/10.1016/j.cageo.2015.09.015');

doi.buildUrl('http://www.doi.org/10.1016/j.cageo.2015.09.015');

doi.buildUrl('http://doi.org/10.1016/j.cageo.2015.09.015');

doi.buildUrl('doi:10.1016/j.cageo.2015.09.015');

// All of these produce a normalized, secure DOI url:

// https://doi.org/10.1016/j.cageo.2015.09.015

```

## Included Utilities

- `validate` - Validates if a single DOI string is valid, is tolerant of leading link or `doi:` strings.

- `validatePart` - Validate the "10.1016/j.cageo.2015.09.015" part of a DOI.

- `normalize` - Normalizes a DOI url or string into a DOI of the form `10.1000/xyz000`

- `buildUrl` - Builds a URL to https://doi.org, includes normalization

- `isOpenFunderRegistry` - Returns true if the DOI is in the [Open Funder Registry](https://www.crossref.org/documentation/funder-registry/)

## Options

- `strict`: only accept doi.org URLs and `doi:` prefixes

---

As of v2.0.0 this package is [ESM only](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c).

---



  Made with love by

  

    Continuous Science Foundation