PhotoshopのUXPスクリプト入門｜PSJS・awaitとJSXとの違い

2026年9月29日2026年10月3日

UXPスクリプトは、.psjsというJavaScriptファイルからPhotoshopを操作する仕組みです。

スタンドアロンの実行はPhotoshop 23.5以降で使えます。

JSXの拡張子を変えるだけの移行ではなく、API・非同期処理・画面とファイル権限を確認します。

最初は文書の情報を読む

練習ZIPのscene-landscape.jpgを作業コピーで開き、article-1362-report.psjsを［ファイル］→［スクリプト］→［参照］から実行します。

文書名と400×200pxの表示を確認する例で、画像の内容や寸法は変更しません。

文書がない場合は、開いてから試すメッセージを表示します。

const { app, core } = require("photoshop");
if (app.documents.length === 0) {
    await core.showAlert("No document is open. Open a practice image and try again.");
} else {
    const doc = app.activeDocument;
    await core.showAlert("Document: " + doc.name + "\nSize: " + doc.width + " x " + doc.height + " px");
}

app.documents.lengthやdoc.widthなどのプロパティを読む処理と、完了を待つAPIを区別します。

showAlertの前にはawaitを置いて、ダイアログの処理を待ちます。

通常のブラウザーやNode.jsのAPIが、そのままPhotoshop UXPにあるとは判断しないでください。

新しい未保存の文書を作る

作業中の文書は自分で保存して閉じ、article-1362-create.psjsを実行します。

この例は文書が開いている場合に停止し、空の状態から256×128px、RGB・8bit、72ppi、透明背景の新しい練習文書とレイヤーを作ります。

既存画像を閉じたり、保存先へファイルを書いたりする処理はありません。

const { app, core } = require("photoshop");
if (app.documents.length !== 0) {
    await core.showAlert("Save and close your current documents before this practice.");
} else {
    try {
        const doc = await app.documents.add({
            name: "CGM UXP Practice",
            width: 256,
            height: 128,
            resolution: 72,
            depth: 8,
            mode: "RGBColorMode",
            fill: "transparent"
        });
        await doc.createLayer({ name: "CGM practice layer" });
        await core.showAlert("Created a new unsaved practice document: " + doc.name +
            "\nSize: " + doc.width + " x " + doc.height + " px");
    } catch (e) {
        await core.showAlert("Practice failed: " + e.message +
            "\nIf a new practice document remains open, inspect it before closing without saving.");
    }
}

app.documents.addはPromiseを返すため、awaitで文書作成を待ってから、その文書にレイヤーを作ります。

レイヤー作成も待ってから完了表示を出します。

作成後は文書名、256×128pxの寸法、CGM practice layerというレイヤーを確認し、不要な練習文書は保存せず閉じます。

途中でレイヤー作成などが失敗した場合、新しい練習文書だけが残る可能性があります。

エラーメッセージを読み、残った文書の内容を確認してください。

エラーが表示されたのに、作成途中の文書を完成品として保存しないようにします。

JSXから移すときの違い

確認する項目	JSX	スタンドアロンPSJS
実行するファイル	.jsx、ExtendScript	.psjs、UXP
アプリへアクセス	グローバルのappなど	require('photoshop').app
処理の完了待ち	従来DOMは同期処理	Promiseを返すメソッドはawait
UI	ScriptUIのdialog	UXPのダイアログとawait showModal
ファイル選択	File・Folder	uxp.storage.localFileSystemのピッカー