Edit in GitHubLog an issue

Documents

A collections class allowing for array access into the application's list of documents that are currently open, while also providing familiar methods from ExtendScript, like getByName.

Copied to your clipboard
// Iterate through all the documents
app.documents.forEach(h => console.log(h.title));

Indexable

▪ [index: number]: Document

Used to access the documents in the collection.

Copied to your clipboard
// Iterate through all the documents
app.documents.forEach(h => console.log(h.title));

Properties

NameTypeAccessMin VersionDescription
length
number
R
22.5
Number of Document elements in this collection.
parent
R
22.5
The owner application of this Documents collection.
typename
string
R
22.5
The name for this object collection: Documents.

Methods

add

22.5

async : Promise<Document>

Create a new document.

No options will create a document of 7 x 5 inches at 300 pixels per inch. This is the same as the "Default Photoshop Size" preset.

An object with a 'preset' string parameter can be used to specify any of the other presets that come installed with Photoshop or created by users.

An object with one or more parameters can also be supplied. Any parameter missing will be set to the default of: width 2100 pixels, height 1500 pixels, resolution 300 pixels per inch, mode: @RGBColorMode and a fill of white with no transparency.

Copied to your clipboard
// "Default Photoshop Size" 7x5 inches at 300ppi
let newDoc1 = await app.documents.add();
let newDoc2 = await app.documents.add({
width: 800,
height: 600,
resolution: 300,
mode: "RGBColorMode",
fill: "transparent"
});
let newDoc3 = await app.documents.add({preset: "My Default Size 1"});

Parameters

NameTypeDescription
options?
@DocumentCreateOptions

getByName

22.5

Document

Find the first document with the matching name.

Parameters

NameType
name
string
  • Privacy
  • Terms of Use
  • Do not sell or share my personal information
  • AdChoices
Copyright © 2024 Adobe. All rights reserved.