Known Issues and Workarounds

Dialog modal state

Using a dialog element's showModal method does not put Photoshop into a modal state as expected of a dialog. There is an options parameter available in Photoshop to enable the modal state. Sending the option lockDocumentFocus: true will tell Photoshop to lock the UI while the dialog is up.

Copy
document.querySelector("dialog").showModal({lockDocumentFocus: true});
Copied to your clipboard
document.querySelector("dialog").showModal({lockDocumentFocus: true});

Photoshop 23.4.1 (July 2022)

Increased batchPlay throwing

A change was introduced in Photoshop which will cause batchPlay calls to throw more often on a bad request. In this update in particular, the move command on layers may be more sensitive to the state of your Document, and throw where it previously had not.

We suggest that if you are using batchPlay to enhance your plugin, that you guard against such possibilities with an appropriate try-catch block, or use the DOM APIs when applicable.