Clipboard

Access the device clipboard from your web app using the Median JavaScript Bridge. You can both write text to the clipboard and read the current clipboard contents.

👍

Developer Demo

Try it live: Load https://median.dev/clipboard/ in your Median app to test clipboard functionality during development.

Overview

The median.clipboard API exposes two methods:

Both iOS and Android are supported. clipboard.get() supports two async patterns: Promises and named callback functions.

Implementation Guide

Writing to the Clipboard

Use median.clipboard.set() to copy a string to the system clipboard. This is the equivalent of a user pressing Ctrl+C / Cmd+C on their desktop browser.

↔️Median JavaScript Bridge

JavaScript

median.clipboard.set({ data: "Text to copy" });

Parameter

Example use case: Providing a "Copy to clipboard" button for invite codes, promo codes, links or other content.

document.getElementById("copy-btn").addEventListener("click", function () {
  median.clipboard.set({ data: "PROMO2024" });
});

Reading from the Clipboard

Use median.clipboard.get() to retrieve the current clipboard contents. This method is asynchronous and returns a result object with either a data property (on success) or an error property (on failure).

Choose the pattern that best fits your codebase: Promises or Callbacks.

Option 1 - Promise (Recommended)

Promises integrate cleanly with async/await and modern JavaScript workflows.

↔️Median JavaScript Bridge

JavaScript

median.clipboard.get().then(function (result) {
  if (result.data) {
    console.log("Clipboard contents:", result.data);
  } else {
    console.error("Clipboard error:", result.error);
  }
});

// Using async/await

async function readClipboard() {
  const result = await median.clipboard.get();

  if (result.data) {
    console.log("Clipboard contents:", result.data);
  } else {
    console.error("Clipboard error:", result.error);
  }
}

Option 2 - Named Callback

Named callbacks are useful when integrating with legacy codebases or when you need the function to be callable from native app contexts.

Pass the name of your callback function as a string using the callback key:

↔️Median JavaScript Bridge

JavaScript

median.clipboard.get({ callback: "clipboardCallback" });

function clipboardCallback(result) {
  if (result.data) {
    console.log("Clipboard contents:", result.data);
  } else {
    console.error("Clipboard error:", result.error);
  }
}

Response Object

Both clipboard.get() patterns return the same result object:

Always check for result.data before using the value, and handle the result.error case gracefully.

Platform Behavior

• iOS: On iOS 14+, the system may display a notification banner informing the user that your app has accessed the clipboard. This is an OS-level behavior and cannot be suppressed.
• Android: Clipboard read access may be restricted on Android 10+ when your app is not in the foreground. Ensure clipboard reads are triggered by an explicit user action.