From 717d4a7ada6f82a8dce8f801a7136d15c3b17df1 Mon Sep 17 00:00:00 2001
From: Andrey Lushnikov <aslushnikov@gmail.com>
Date: Sat, 7 Apr 2018 18:01:31 -0700
Subject: [PATCH] docs(api): warn about slow screenshots on OS X (#2326)

---
 docs/api.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/api.md b/docs/api.md
index 7744d3ac..83b9ab16 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -1162,6 +1162,8 @@ Shortcut for [page.mainFrame().executionContext().queryObjects(prototypeHandle)]
   - `omitBackground` <[boolean]> Hides default white background and allows capturing screenshots with transparency. Defaults to `false`.
 - returns: <[Promise]<[Buffer]>> Promise which resolves to buffer with captured screenshot
 
+> **NOTE** Screenshots take at least 1/6 second on OS X. See https://crbug.com/741689 for discussion.
+
 #### page.select(selector, ...values)
 - `selector` <[string]> A [selector] to query page for
 - `...values` <...[string]> Values of options to select. If the `<select>` has the `multiple` attribute, all values are considered, otherwise only the first one is taken into account.