Skip to content
packagesspecbrowser

@vltpkg/spec/browser

Classes

Spec

Defined in: spec/src/browser.ts:171

The base, isomorphic Spec implementation.

Extended by

Implements

Constructors

new Spec()
new Spec(
   name,
   bareSpec,
   options?): Spec

Defined in: spec/src/browser.ts:299

Parameters
name

string

bareSpec

string

options?

SpecOptions

Returns

Spec

new Spec()
new Spec(spec, options?): Spec

Defined in: spec/src/browser.ts:300

Parameters
spec

string

options?

SpecOptions

Returns

Spec

new Spec()
new Spec(
   spec,
   bareOrOptions?,
   options?): Spec

Defined in: spec/src/browser.ts:301

Parameters
spec

string | Spec

bareOrOptions?

string | SpecOptions

options?

SpecOptions

Returns

Spec

Properties

bareSpec
bareSpec: string

Defined in: spec/src/browser.ts:238

just the part AFTER the name, so 1.x in [email protected]

Implementation of
SpecLike.bareSpec
catalog?
optional catalog: string;

Defined in: spec/src/browser.ts:257

constructor
constructor: typeof Spec

Defined in: spec/src/browser.ts:297

The initial value of Object.prototype.constructor is the standard built-in Object constructor.

conventionalRegistryTarball?
optional conventionalRegistryTarball: string;

Defined in: spec/src/browser.ts:251

conventional location of the tarball on the registry, if it can be guessed. This is only attempted if the spec is a registry type, with a single version comparator. This can be used to elide resolved urls that are repetitive and predictable.

Implementation of
SpecLike.conventionalRegistryTarball
distTag?
optional distTag: string;

Defined in: spec/src/browser.ts:254

a dist-tag like ‘latest’

Implementation of
SpecLike.distTag
file?
optional file: string;

Defined in: spec/src/browser.ts:256

file path for file:// url specs

Implementation of
SpecLike.file
gitCommittish?
optional gitCommittish: string;

Defined in: spec/src/browser.ts:242

the commit value we will check out

Implementation of
SpecLike.gitCommittish
gitRemote?
optional gitRemote: string;

Defined in: spec/src/browser.ts:239

the git remote to fetch from

Implementation of
SpecLike.gitRemote
gitSelector?
optional gitSelector: string;

Defined in: spec/src/browser.ts:240

the committish, semver range, and/or path portion of a git remote

Implementation of
SpecLike.gitSelector
gitSelectorParsed?
optional gitSelectorParsed: GitSelectorParsed;

Defined in: spec/src/browser.ts:241

the parsed ’::‘-separated key/value pairs: semver:<range> and path:<subpath>

Implementation of
SpecLike.gitSelectorParsed
name
name: string

Defined in: spec/src/browser.ts:235

the name portion, so foo in [email protected]

Implementation of
SpecLike.name
namedGitHost?
optional namedGitHost: string;

Defined in: spec/src/browser.ts:243

github, gitlab, bitbucket, gist, etc.

Implementation of
SpecLike.namedGitHost
namedGitHostPath?
optional namedGitHostPath: string;

Defined in: spec/src/browser.ts:244

the path that’s parsed when we have a named git host

Implementation of
SpecLike.namedGitHostPath
namedJsrRegistry?
optional namedJsrRegistry: string;

Defined in: spec/src/browser.ts:248

namedRegistry?
optional namedRegistry: string;

Defined in: spec/src/browser.ts:247

In specs like foo@npm:bar@1, this is the ‘npm’ part. Other registries can be mapped using the registries option.

Implementation of
SpecLike.namedRegistry
options
options: SpecOptionsFilled

Defined in: spec/src/browser.ts:234

options passed to the constructor, plus defaults

Implementation of
SpecLike.options
overridden
overridden: boolean = false

Defined in: spec/src/browser.ts:259

Is this a spec that overrides another spec?

Implementation of
SpecLike.overridden
range?
optional range: Range;

Defined in: spec/src/browser.ts:253

parsed semver range specifier

Implementation of
SpecLike.range
registry?
optional registry: string;

Defined in: spec/src/browser.ts:249

registry to consult to resolve this spec

Implementation of
SpecLike.registry
registrySpec?
optional registrySpec: string;

Defined in: spec/src/browser.ts:250

semver range or dist-tag for resolving against a packument

Implementation of
SpecLike.registrySpec
remoteURL?
optional remoteURL: string;

Defined in: spec/src/browser.ts:255

URL to download a tarball from, if it can be determined.

This is set for url specs of course, but also git remotes on known hosts that provide a gitHostArchive template.

Implementation of
SpecLike.remoteURL
scope?
optional scope: `@${string}`;

Defined in: spec/src/browser.ts:236

the name’s scope, so @acme in @acme/[email protected]

Implementation of
SpecLike.scope
scopeRegistry?
optional scopeRegistry: string;

Defined in: spec/src/browser.ts:237

if the name is scoped, and there’s a registry associated with the scope, then this is that registry

Implementation of
SpecLike.scopeRegistry
semver?
optional semver: string;

Defined in: spec/src/browser.ts:252

spec to resolve against available versions

Implementation of
SpecLike.semver
spec
spec: string

Defined in: spec/src/browser.ts:233

the full named specifier passed to the constructor

Implementation of
SpecLike.spec
subspec?
optional subspec: Spec;

Defined in: spec/src/browser.ts:258

in bar@npm:[email protected], this is the spec for [email protected]

Implementation of
SpecLike.subspec
type
type: SpecType

Defined in: spec/src/browser.ts:232

the type of spec that this is, ultimately

Implementation of
SpecLike.type
workspace?
optional workspace: string;

Defined in: spec/src/browser.ts:246

the package name or path of the workspace being referenced

Implementation of
SpecLike.workspace
workspaceSpec?
optional workspaceSpec: string;

Defined in: spec/src/browser.ts:245

the specifier when using workspace: specs This can be either a semver range, *, ~, or ^, if the name is not modified. Or, it can include a workspace package name or path, like workspace:packages/foo@* or workspace:@scope/foo@*.

Implementation of
SpecLike.workspaceSpec
nodejsDependencies?
static optional nodejsDependencies: NodeJSDependenciesOptions;

Defined in: spec/src/browser.ts:230

Accessors

final
Get Signature
get final(): Spec & object

Defined in: spec/src/browser.ts:268

Return the final entry in the chain of subspecs When deciding which thing to actually fetch, spec.final is the thing to look at.

Returns

Spec & object

Implementation of
SpecLike.final
inheritedRegistry
Set Signature
set inheritedRegistry(reg): void

Defined in: spec/src/browser.ts:771

Sets a registry value that should be used for this spec in case it is currently just following the default registry.

Parameters
reg

undefined | string

Returns

void

Implementation of
SpecLike.inheritedRegistry

Methods

[kCustomInspect]()
kCustomInspect: string

Defined in: spec/src/browser.ts:689

Returns

string

toString()
toString(): string

Defined in: spec/src/browser.ts:287

Normally, the string value of a Spec is just the string passed in to be parsed. However, in the case of a chain of subspecs, like foo@npm:bar@npm:baz@npm:quux@latest, this simplifies out the middle parts of the chain, returning just foo@npm:quux@latest

Returns

string

Implementation of
SpecLike.toString
parse()
Call Signature
static parse(
   name,
   bareSpec,
   options?): Spec

Defined in: spec/src/browser.ts:178

Create a Spec object from a full spec, name+bareSpec, or Spec object

Note: If a Spec object is provided, it is returned as-is, without investigating whether the options match.

Parameters
name

string

bareSpec

string

options?

SpecOptions

Returns

Spec

Call Signature
static parse(spec, options?): Spec

Defined in: spec/src/browser.ts:183

Create a Spec object from a full spec, name+bareSpec, or Spec object

Note: If a Spec object is provided, it is returned as-is, without investigating whether the options match.

Parameters
spec

string

options?

SpecOptions

Returns

Spec

Call Signature
static parse(spec, options?): Spec

Defined in: spec/src/browser.ts:184

Create a Spec object from a full spec, name+bareSpec, or Spec object

Note: If a Spec object is provided, it is returned as-is, without investigating whether the options match.

Parameters
spec

Spec

options?

SpecOptions

Returns

Spec

parseArgs()
static parseArgs(specOrBareSpec, opts?): Spec

Defined in: spec/src/browser.ts:195

Parameters
specOrBareSpec

string

opts?

SpecOptions

Returns

Spec

parseGitSelector()
static parseGitSelector(selector, spec?): [GitSelectorParsed, string, Range]

Defined in: spec/src/browser.ts:785

Should only ever be called with the bit that comes AFTER the # in the git remote url.

Parameters
selector

string

spec?

Spec

Returns

[GitSelectorParsed, string, Range]

Type Aliases

NodeJSDependenciesOptions

type NodeJSDependenciesOptions = object

Defined in: spec/src/browser.ts:148

Injects the Node.js dependencies into the Spec class.

Type declaration

homedir
homedir: homedir
isAbsolute
isAbsolute: isAbsolute
join
join: join
resolve
resolve: resolve
winPath
winPath: win32

Variables

defaultGitHostArchives

const defaultGitHostArchives: object

Defined in: spec/src/browser.ts:33

Type declaration

bitbucket
bitbucket: string =
  'https://bitbucket.org/$1/$2/get/$committish.tar.gz'
gist
gist: string =
  'https://codeload.github.com/gist/$1/tar.gz/$committish'
github
github: string =
  'https://api.github.com/repos/$1/$2/tarball/$committish'
gitlab
gitlab: string =
  'https://gitlab.com/$1/$2/repository/archive.tar.gz?ref=$committish'

defaultGitHosts

const defaultGitHosts: object

Defined in: spec/src/browser.ts:26

Type declaration

bitbucket
bitbucket: string = 'git+ssh://[email protected]:$1/$2.git'
gist
gist: string = 'git+ssh://[email protected]/$1.git'
github
github: string = 'git+ssh://[email protected]:$1/$2.git'
gitlab
gitlab: string = 'git+ssh://[email protected]:$1/$2.git'

defaultJsrRegistries

const defaultJsrRegistries: object

Defined in: spec/src/browser.ts:24

Type declaration

jsr
jsr: string = 'https://npm.jsr.io/'

defaultRegistries

const defaultRegistries: object

Defined in: spec/src/browser.ts:19

Type declaration

gh
gh: string = 'https://npm.pkg.github.com/'
npm
npm: string = defaultRegistry

defaultRegistry

const defaultRegistry: 'https://registry.npmjs.org/' =
  'https://registry.npmjs.org/'

Defined in: spec/src/browser.ts:17

defaultScopeRegistries

const defaultScopeRegistries: object

Defined in: spec/src/browser.ts:56

Type declaration

@jsr
@jsr: string = 'https://npm.jsr.io/';

gitHostWebsites

const gitHostWebsites: object

Defined in: spec/src/browser.ts:49

These are just for legacy support of urls that are supported by npm and observed in the wild.

Not configurable, because no more will be added. If you wish to define custom git hosts, use it with the 'git-hosts' and 'git-host-archives' options.

Type declaration

bitbucket
bitbucket: string = 'https://bitbucket.org/'
gist
gist: string = 'https://gist.github.com/'
github
github: string = 'https://github.com/'
gitlab
gitlab: string = 'https://gitlab.com/'

kCustomInspect

const kCustomInspect: typeof kCustomInspect

Defined in: spec/src/browser.ts:15

Functions

getNormalizeFile()

function getNormalizeFile(opts?): (bareSpec, spec) => [string, string]

Defined in: spec/src/browser.ts:861

Parameters

opts?

NodeJSDependenciesOptions

Returns

Function

Parameters
bareSpec

string

spec

Spec

Returns

[string, string]

getOptions()

function getOptions(options?): SpecOptionsFilled

Defined in: spec/src/browser.ts:60

Parameters

options?

SpecOptions

Returns

SpecOptionsFilled

isSpec()

function isSpec(spec): spec is Spec

Defined in: spec/src/browser.ts:156

Parameters

spec

unknown

Returns

spec is Spec

References

GitSelectorParsed

Re-exports GitSelectorParsed

Scope

Re-exports Scope

SpecLike

Re-exports SpecLike

SpecLikeBase

Re-exports SpecLikeBase

SpecOptions

Re-exports SpecOptions

SpecOptionsFilled

Re-exports SpecOptionsFilled

SpecType

Re-exports SpecType