Text Operations

/**
 * Gets the content of the user's clipboard. On web, this prompts the user 
 * to grant permission to "see text and images copied to the clipboard."
 * @param options - Options for the clipboard content to be retrieved
 * @returns Promise that resolves to the clipboard content
 */
function getStringAsync(options?: GetStringOptions): Promise<string>;

interface GetStringOptions {
  /** The target format of the clipboard string to be converted to, if possible */
  preferredFormat?: StringFormat;
}

enum StringFormat {
  PLAIN_TEXT = 'plainText',
  HTML = 'html'
}

import * as Clipboard from "expo-clipboard";

// Get plain text (default)
const text = await Clipboard.getStringAsync();

// Get HTML content if available, fallback to plain text
const htmlContent = await Clipboard.getStringAsync({
  preferredFormat: Clipboard.StringFormat.HTML
});

/**
 * Sets the content of the user's clipboard
 * @param text - The string to save to the clipboard
 * @param options - Options for the clipboard content to be set
 * @returns Promise resolving to boolean on web (success indicator), always true on iOS/Android
 */
function setStringAsync(text: string, options?: SetStringOptions): Promise<boolean>;

interface SetStringOptions {
  /** The input format of the provided string. Helps other applications interpret the content properly */
  inputFormat?: StringFormat;
}

import * as Clipboard from "expo-clipboard";

// Set plain text
await Clipboard.setStringAsync("Hello, world!");

// Set HTML content
await Clipboard.setStringAsync(
  "<p><strong>Bold text</strong> and <em>italic text</em></p>",
  { inputFormat: Clipboard.StringFormat.HTML }
);

// Check if operation succeeded (mainly useful on Web)
const success = await Clipboard.setStringAsync("Copy this text");
if (success) {
  console.log("Text copied successfully");
}

/**
 * Sets the content of the user's clipboard
 * @deprecated Use setStringAsync() instead
 * @param text - The string to save to the clipboard
 * @returns void on native platforms, boolean on web
 */
function setString(text: string): void;

/**
 * Returns whether the clipboard has text content. Returns true for both plain text and rich text (HTML).
 * On web, this requires user permission to "see text and images copied to the clipboard"
 * @returns Promise that resolves to true if clipboard has text content, false otherwise
 */
function hasStringAsync(): Promise<boolean>;

import * as Clipboard from "expo-clipboard";

// Check if clipboard has text before attempting to read
if (await Clipboard.hasStringAsync()) {
  const text = await Clipboard.getStringAsync();
  console.log("Clipboard contains:", text);
} else {
  console.log("Clipboard is empty or contains non-text content");
}

// Conditional UI updates
const hasText = await Clipboard.hasStringAsync();
setPasteButtonEnabled(hasText);

import * as Clipboard from "expo-clipboard";
import { UnavailabilityError } from 'expo-modules-core';

try {
  const text = await Clipboard.getStringAsync();
} catch (error) {
  if (error instanceof UnavailabilityError) {
    console.log("Clipboard not available on this platform");
  }
}