Copy page

puter.ui.showSaveFilePicker()

Websites Puter Apps Node.js Workers

Presents the user with a file picker dialog allowing them to specify where and with what name to save a file.

Syntax 

puter.ui.showSaveFilePicker()
puter.ui.showSaveFilePicker(content, suggestedName)
puter.ui.showSaveFilePicker(content, suggestedName, type)

Parameters

content (Optional)

The data to write to the chosen file. The expected value depends on type:

  • When type is omitted, content is the file data to write.
  • When type is 'url', content is a URL (string or URL) whose contents are saved.
  • When type is 'move' or 'copy', content is the source path of an existing file to move or copy.

suggestedName (String) (Optional)

The default file name to pre-fill in the dialog.

type (String) (Optional)

How content should be interpreted. One of 'url', 'move', or 'copy'. If omitted and content is a URL object, it is auto-detected as 'url'.

Return value

A Promise that resolves to an FSItem describing the saved file. If the user cancels, the promise stays pending.

Examples 

<html>
<body>
    <script src="https://js.puter.com/v2/"></script>
    <h1 id="file-name"></h1>

    <button id="save-file">Save file</button>
    <pre><code id="file-content"></code></pre>

    <script>
        document.getElementById('save-file').addEventListener('click', ()=>{
            puter.ui.showSaveFilePicker("Hello world! I'm the content of this file.", 'Untitled.txt').then(async (file)=>{
                // print file name
                document.getElementById('file-name').innerHTML = file.name;
                // print file content
                document.getElementById('file-content').innerText = await (await file.read()).text();
            });
        });
    </script>
</body>
</html>

NEXT

showSpinner()

PREVIOUS

showOpenFilePicker()