parse-srcset

library1.0.2jsnpmunverified

parse-srcset is a JavaScript parser for the HTML5 `srcset` attribute, designed to be spec-conformant with the WHATWG reference algorithm. It takes a `srcset` string as input and returns an array of objects, each representing a potential image source with properties like `url`, `width`, `height`, and `density`. The package is at version 1.0.2, with its last known update around 10 years ago, indicating it is no longer actively maintained. While it provides a foundational implementation for `srcset` parsing, developers seeking current specifications, ongoing support, or additional features like stringification should consider more recently updated alternatives. Its release cadence was sporadic, reflecting its early development and subsequent abandonment, distinguishing it from modern, regularly updated libraries in this domain. The library relies on an extensive test suite to ensure conformance to the W3C srcset checker, a strong point at the time of its development.

web-framework

npm install parse-srcset

github ↗package ↗

INSTALL

IMPORT

SIG · PARSE-SRCSET

parse-srcset

web-frameworkjavascriptv1.0.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

parseSrcset

✓ const parseSrcset = require('parse-srcset');

✗ import parseSrcset from 'parse-srcset';

This package (v1.0.2) is a CommonJS module. Use `require()` for Node.js environments. Attempting `import ... from` will likely result in a `TypeError` if not handled by a bundler.

parseSrcset

✓ import parseSrcset from '@prettier/parse-srcset';

✗ const parseSrcset = require('parse-srcset');

While this entry focuses on `parse-srcset` (albell's), a popular, actively maintained fork by Prettier exists under `@prettier/parse-srcset`. This fork uses modern ESM syntax and is recommended for new projects.

parse

✓ import { parse } from 'srcset';

✗ import parse from 'parse-srcset';

Another actively maintained alternative, `srcset`, provides both parsing and stringifying functionality. Its primary parsing function is named `parse` and is typically imported as a named export.

This quickstart demonstrates how to parse a standard HTML `srcset` string using `require()` and then iterates through the resulting array of image source objects, logging their URLs and descriptors (density or width).

Debug

Known issues

breakingThis package (albell/parse-srcset) is largely unmaintained, with its last release over a decade ago (v1.0.2). It may not support newer srcset syntaxes or edge cases introduced after its last update.

fix

For new projects or if encountering parsing issues with modern srcset attributes, consider using actively maintained alternatives like `@prettier/parse-srcset` or `srcset`.

affects: >=1.0.2

gotchaThe `parse-srcset` package is a CommonJS module. Directly using `import parseSrcset from 'parse-srcset'` in an ES Module context without proper transpilation or bundler configuration will likely result in runtime errors (e.g., `TypeError: parseSrcset is not a function` or issues with default exports).

fix

In Node.js ES Module environments, use `const parseSrcset = require('parse-srcset');` or rely on bundlers like Webpack/Rollup to handle CJS-ESM interoperability. For pure ESM, prefer the `@prettier/parse-srcset` fork or the `srcset` package which offer native ESM support.

affects: >=1.0.0

deprecatedThe original `parse-srcset` library lacks modern tooling and features like TypeScript declarations. While functional, its maintenance status and lack of updates mean it will not receive bug fixes or performance improvements.

fix

Migrate to `srcset` (e.g., `npm install srcset`) or `@prettier/parse-srcset` (e.g., `npm install @prettier/parse-srcset`) for TypeScript support, active development, and potentially better performance/spec compliance.

affects: >=1.0.0

gotchaOlder parsers might not fully align with the most recent `srcset` specifications or common browser interpretations for complex or malformed inputs, potentially leading to 'Failed parsing srcset attribute' errors or incorrect output for specific descriptors like `w` and `x` in combination.

fix

Thoroughly test parsing results with various `srcset` inputs, especially those involving modern descriptors or edge cases. Consider using a more actively maintained library for guaranteed spec compliance.

affects: <=1.0.2

Errors

Common errors & fixes

TypeError: parseSrcset is not a function

Attempting to use `import parseSrcset from 'parse-srcset';` when the package is a CommonJS module that exports the function directly (i.e., `module.exports = function(){...}`). ESM imports of CJS modules often wrap the default export under a `default` property, causing this error.

fix

Change the import statement to `const parseSrcset = require('parse-srcset');` in Node.js environments. If using a bundler, ensure it is configured to correctly handle CJS-ESM interoperability. For new projects in ESM, use `@prettier/parse-srcset` or `srcset`.

ERR_REQUIRE_ESM

Trying to `require()` an ES Module or importing an old CJS module into a strict ESM context where `require` is not available or explicitly disallowed.

fix

The `parse-srcset` package is CJS. Ensure your environment allows `require()` or use a bundler. For pure ESM projects, migrate to `@prettier/parse-srcset` or `srcset` which provide ESM compatibility.

Failed parsing 'srcset' attribute value since it has an unknown descriptor.

The input `srcset` string contains syntax or descriptors (e.g., unsupported combinations of `w` and `x` descriptors) that the older parser version (1.0.2) does not recognize or support due to potential updates in the HTML specification or browser implementations since its last release.

fix

Verify the `srcset` string against the WHATWG HTML specification for `srcset`. If the syntax is valid according to current specs, the parser itself is outdated. Upgrade to a modern `srcset` parsing library like `@prettier/parse-srcset` or `srcset` which are actively maintained and more likely to be spec-compliant.

Upgrade

Version history

1.0.2latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/albell/parse-srcset ↗

packagehttps://www.npmjs.com/package/parse-srcset ↗