Dreamweaver API リファレンス

3.0

指定したファイルをコピーします。

originalURL, copyURL
originalURL
コピーするファイルを URL 形式で指定します。
copyURL
コピー先のファイルを URL 形式で指定します。

ファイルのコピーに成功した場合には true、失敗した場合には false を返します。

menus.xml を menus.bak にコピーします。
var menufile = dw.getConfigurationPath() + "/menus/menus.xml";
var bakfile = dw.getConfigurationPath() + "/menus/menus.bak";
DWfile.copy( menufile, bakfile );

2.0 以上

フォルダを新規作成します。

folderURL
新規に作成するフォルダ URL 形式で指定します。

フォルダに作成に成功した場合は true、失敗した場合には false を返します。

現在のサイトに flash フォルダを作成します。
var flashFolder = dw.getSiteRoot() + "/flash";
DWfile.createFolder( flashFolder );

2.0 以上

指定したファイルが存在するか調べます。

fileURL
チェックするファイルを URL 形式で指定します。

ファイルが存在するときは true、存在しない場合は false を返します。

menus.xml を menus.bak にコピーする前に、menus.bak が存在するかどうか調べ存在する場合に警告を表示します。
var menufile = dw.getConfigurationPath() + "/menus/menus.xml";
var bakfile = dw.getConfigurationPath() + "/menus/menus.bak";
if( DWfile.exists( bakfile ) )
{
alert( "ファイルが上書きされます。" );
}
DWfile.copy( menufile, bakfile );

2.0 以上

指定したファイルまたはフォルダの属性を取得します。

fileURL
属性を取得するファイルまたはフォルダを URL 形式で指定します。

属性値の結果の文字列を返します。ファイルまたはフォルダが存在しない場合は、 null を返します。
属性値は以下の文字を組み合わせた文字列が返されます。
R - 読み取り専用
D - ディレクトリ
H - 隠しファイルまたはフォルダ
S - システムファイルまたはシステムフォルダ

menus.xml を menus.bak にコピーする前に、menus.bak が読み取り属性が設定されている場合にはコピーしません。
var menufile = dw.getConfigurationPath() + "/menus/menus.xml";
var bakfile = dw.getConfigurationPath() + "/menus/menus.bak";
var str = DWfile.getAttributes( bakfile );
if( str == null || ( str.indexOf( "R" ) == -1 ) )
{
DWfile.copy( menufile, bakfile );
}

2.0 以上

指定したファイルが最後に修正された日時を取得します。

fileURL
日時を取得したいファイル名を URL 形式で指定します。

基準時刻からの経過時間を１６進数の文字列で返します。Window 版とMacintosh 版では、基準時刻と経過時間の単位が異なります。Windows 版は、基準時刻は 1600 年 1 月 1 日からの 100ns 単位の経過時間、Macintosh 版では、1904年 1 月 1 日からの 秒単位の経過時間を返します。

二つのファイルの日時を調べ、コピーするファイルを変更します。
var file1 = "file:///D|/site/index.htm";
var file2 = "file:///D|/site2/index.htm";
var date1 = DWfile.getModificationDate( file1 );
var date2 = DWfile.getModificationDate( file2 );
if( data1 > date 2 )
{
DWfile.copy( file1, file2 );
}
else
{
DWfile.copy( file2, file1 );
}

2.0 以上

指定したフォルダ内にあるファイルまたはフォルダの文字列リストを取得します。

folderURL, constraint
folderURL
リスト取得するフォルダを file:// URL 形式で指定します。また、ワイルドカードのファイルマスクを追加することが出来ます。試用できるワイルドカードは、「*」（1 つ以上の文字に一致）と「?」（1 つの文字に一致）です。
constraint
取得するリストの種類を指定します。ファイルだけを取得したい場合には "files"、フォルダだけを取得したい場合には、"directories" を指定します。この引数を指定しない場合は、ファイルとディレクトリの両方を返します。

取得したファイルまたはフォルダの文字列リストを返します。

サイトのルートフォルダ内にある *.htm ファイルを表示します。
var list = DWfile.listFolder( dw.getSiteRoot() + "*.htm" );
alert( list );

2.0 以上

指定したファイルの内容を取得します。

fileURL
内容を取得するファイルを URL 形式で指定します。

ファイルの内容の文字列を返し、ファイルの読み込みに失敗した場合には null を返します。

mydata.txt を読み込み、内容を表示します。
var dat = DWfile.read( "file:///D|/mydata.txt" );
if( dat != null )
alert( dat );

3.0

指定したファイルを削除します。
注意:
Windows 版では、指定したファイルが読み取り専用の場合に、確認のダイアログボックスが表示されます。

fileURL
削除するファイルを URL 形式で指定します。

削除に成功した場合は true、失敗した場合は fakse を返します。
サイトの /TMP 内にあるファイルをすべて削除します。
var folder = dw.getSiteRoot() + "TMP/";
var list = DWfile.listFolder( folder, "files" );
for( var i = 0; i < list.length; i++ )
{
DWfile.remove( folder + list[ i ] );
}

2.0 以上

指定した内容をファイルに保存します。指定したファイルが存在しない場合には、ファイルを作成します。

fileURL, text, mode
保存するファイルを URL 形式で指定します。
text
ファイルに保存する内容を指定します。
mode
追加書き込みする場合は "append" を指定し、上書きする場合は、この引数を指定しないようにします。

ファイルの書き込みに成功した場合は true、失敗した場合は false を返します。

最初に mydata.txt に "xxx" を上書きし、その後 "aaa" を追加書き込みします。
var fileURL = "file:///D|/mydata.txt";
DWfile.write( fileURL, "xxx" );
DWfile.write( fileURL, "aaa", "append" );