puter.ui.alert()

Displays a Puter alert dialog.

Puter improves upon the traditional browser alerts by providing more flexibility. For example, you can customize the buttons displayed.

The alert blocks the parent window until the user responds by pressing a button.

Syntax

puter.ui.alert(message)
puter.ui.alert(message, buttons)
puter.ui.alert(message, buttons, options)

Parameters

message (optional)

A string to be displayed in the alert dialog. If not set, the dialog will be empty.

buttons (optional)

An array of objects that define the buttons to be displayed in the alert dialog. Each object must have a label property. The value property is optional. If it is not set, the label property will be used as the value. The type property is optional and can be set to primary, success, info, warning, or danger. If it is not set, the default type will be used.

options (optional)

A set of key/value pairs that configure the alert dialog.

Return value

A Promise that resolves to the value of the button pressed. If the value property of button is set it is returned, otherwise label property will be returned.

Examples

Show an alert with three buttons

<html>
<body>
    <script src="https://js.puter.com/v2/"></script>
    <script>
        // display an alert with a message and three different types of buttons
        puter.ui.alert('Please press a button!', [
            {
                label: 'Hello :)',
                value: 'hello',
                type: 'primary',
            },
            {
                label: 'Bye :(',
                type: 'danger',
            },
            {
                label: 'Cancel',
            },
        ]).then((resp) => {
            // print user's response to console
            console.log(resp);
        });
    </script>
</body>
</html>