Valid page in script

Hi @Ghoul Fool ,

in case you were able to start a page section with a page named "0" your alert would return true.

As far as I know this is not possible. The numbering schemes do not allow this. A page name like "001" would be possible or even "0001" or "A" where you could fetch that page with all of the code lines below:

app.documents.item(0).pages.item("A")

app.documents.item(0).pages.itemByName("A")

app.documents[0].pages.item("A")

app.documents[0].pages.itemByName("A")

app.activeDocument.pages.item("A")

app.activeDocument.pages.itemByName("A")

WARNING:

A pages' name is perhaps not unique in a document if the document contains more than one page sections.

With item() and itemByName() you will not get a collection of pages named "A", but only the first instance.

See DOM documentation for document.section

https://www.indesignjs.de/extendscriptAPI/indesign-latest/#Section.html#d1e265407

Also consider that there is a huge difference between PhotoShop and InDesign when it comes to address the "active" document, the front most one. The good news: app.activeDocument is the same for PhotoShop and InDesign.

But if you are using iterators like item(0) or [0] there is a huge difference:

With PhotoShop app.documents[0] could be the active document. If it happens that the first document you opened in a given session is in front and active. In InDesign it absolutely always is the active document if all documents show a layout window. So the iterator numbers of item(i) or [i] of open documents could change if the user brings a different document to the front. Not so in PhotoShop.

Regards,
Uwe Laubender
( Adobe Community Professional )

@brian_p_dts 

Hi Brian -- Actually, pages.item() can be used with strings and integers. When used with an integer, you get the page's document offset, with a string, the string is the folio. So if you have a document with Arabic-style page numbering,

app.documents[0].pages.item('4').name >> 4
app.documents[0].pages.item(4).name >> 5

The good thing of using integers is that you can reference a page no matter is numbering style (Arabic, Roman, letter, etc.). And the good thing of using strings is that you can reference a page with a roman page number, or page numbers with an included section prefix.

To answer this question: why would a page be considered NOT valid

isValid will return a boolean, true or false depending if the object reference is valid or not. For ex, you can reference a page that doesn't exist but you would get an error if you try to use this object. isValid is a property that let you check if the reference is accessible or not.