Add browser support (#61)

Co-authored-by: Sindre Sorhus <sindresorhus@gmail.com>

browser.js

@@ -0,0 +1,16 @@
+/* eslint-env browser */
+'use strict';
+
+export const write = async text => {
+	await navigator.clipboard.writeText(text);
+};
+
+export const read = async () => navigator.clipboard.readText();
+
+export const readSync = () => {
+	throw new Error('`.readSync()` is not supported in browsers!');
+};
+
+export const writeSync = () => {
+	throw new Error('`.writeSync()` is not supported in browsers!');
+};

index.d.ts

@@ -8,6 +8,8 @@ export function write(text: string): Promise<void>;
 /**
 Write (copy) to the clipboard synchronously.
 
+Doesn't work in browsers.
+
 @param text - The text to write to the clipboard.
 
 @example
@@ -29,5 +31,7 @@ export function read(): Promise<string>;
 
 /**
 Read (paste) from the clipboard synchronously.
+
+Doesn't work in browsers.
 */
 export function readSync(): string;

package.json

@@ -18,6 +18,7 @@
 	"files": [
 		"index.js",
 		"index.d.ts",
+		"browser.js",
 		"lib",
 		"fallbacks"
 	],
@@ -43,5 +44,10 @@
 		"ava": "^2.1.0",
 		"tsd": "^0.10.0",
 		"xo": "^0.25.3"
+	},
+	"browser": "browser.js",
+	"exports": {
+		"browser": "./browser.js",
+		"default": "./index.js"
 	}
 }

readme.md

@@ -2,16 +2,14 @@
 
 > Access the system clipboard (copy/paste)
 
-Cross-platform. Supports: macOS, Windows, Linux, OpenBSD, FreeBSD, Android with [Termux](https://termux.com/).
-
+Cross-platform. Supports: macOS, Windows, Linux, OpenBSD, FreeBSD, Android with [Termux](https://termux.com/), [modern browsers](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard_API#Browser_compatibility).
 
 ## Install
 
 ```
 $ npm install clipboardy
 ```
 
-
 ## Usage
 
 ```js
@@ -23,7 +21,6 @@ clipboardy.readSync();
 //=> '🦄'
 ```
 
-
 ## API
 
 ### clipboardy
@@ -46,6 +43,8 @@ Read (paste) from the clipboard asynchronously. Returns a `Promise`.
 
 Write (copy) to the clipboard synchronously.
 
+Doesn't work in browsers.
+
 ##### text
 
 Type: `string`
@@ -56,14 +55,14 @@ The text to write to the clipboard.
 
 Read (paste) from the clipboard synchronously.
 
+Doesn't work in browsers.
 
 ## FAQ
 
 #### Where can I find the source of the bundled binaries?
 
 The [Linux binary](https://github.com/sindresorhus/clipboardy/blob/master/fallbacks/linux/xsel) is just a bundled version of [`xsel`](https://linux.die.net/man/1/xsel). The source for the [Windows binary](https://github.com/sindresorhus/clipboardy/blob/master/fallbacks/windows/clipboard_x86_64.exe) can be found [here](https://github.com/sindresorhus/win-clipboard).
 
-
 ## Related
 
 - [clipboard-cli](https://github.com/sindresorhus/clipboard-cli) - CLI for this module