diff --git a/docs/api.md b/docs/api.md
index 727be831ad..39e46f0ad6 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -492,7 +492,7 @@ page.removeListener('request', logRequest);
- [page.evaluateHandle(pageFunction[, ...args])](#pageevaluatehandlepagefunction-args)
- [page.evaluateOnNewDocument(pageFunction[, ...args])](#pageevaluateonnewdocumentpagefunction-args)
- [page.exposeFunction(name, playwrightFunction)](#pageexposefunctionname-playwrightfunction)
-- [page.fill(selector, value, options)](#pagefillselector-value-options)
+- [page.fill(selector, value[, options])](#pagefillselector-value-options)
- [page.focus(selector, options)](#pagefocusselector-options)
- [page.frames()](#pageframes)
- [page.goBack([options])](#pagegobackoptions)
@@ -518,7 +518,6 @@ page.removeListener('request', logRequest);
- [page.setViewportSize(viewportSize)](#pagesetviewportsizeviewportsize)
- [page.title()](#pagetitle)
- [page.tripleclick(selector[, options])](#pagetripleclickselector-options)
-- [page.type(selector, text[, options])](#pagetypeselector-text-options)
- [page.uncheck(selector, [options])](#pageuncheckselector-options)
- [page.url()](#pageurl)
- [page.viewportSize()](#pageviewportsize)
@@ -1031,20 +1030,33 @@ const fs = require('fs');
})();
```
-#### page.fill(selector, value, options)
+#### page.fill(selector, value[, options])
- `selector` <[string]> A selector to query page for.
- `value` <[string]> Value to fill for the ``, `