get()

Returns a subdomain. If the subdomain does not exist, the promise will be rejected with an error.

Syntax

puter.hosting.get(subdomain)

Parameters

subdomain (String) (required)

A string containing the name of the subdomain you want to retrieve.

Return value

A Promise that will resolve to a subdomain object when the subdomain has been retrieved. If a subdomain with the given name does not exist, the promise will be rejected with an error.

Examples

Get a subdomain

Run

<html>
<body>
    <script src="https://js.puter.com/v2/"></script>
    <script>
        (async () => {
            // (1) Create a random website
            let subdomain = puter.randName();
            const site = await puter.hosting.create(subdomain)
            puter.print(`Website hosted at: ${site.subdomain}.puter.site (This is an empty website with no files)<br>`);

            // (2) Retrieve the website using get()
            const site2 = await puter.hosting.get(site.subdomain);
            puter.print(`Website retrieved: subdomain=${site2.subdomain}.puter.site UID=${site2.uid}<br>`);

            // (3) Delete the website (cleanup)
            await puter.hosting.delete(subdomain);
        })();
    </script>
</body>
</html>