add builtins assumptions (#2283)

* add builtins assumptions * Update docs/caveats.md Co-authored-by: Brian Ng <bng412@gmail.com> Co-authored-by: Brian Ng <bng412@gmail.com>
babel · Aug 4, 2020 · 5a17280 · 5a17280
1 parent afb8e9f
commit 5a17280
Show file tree

Hide file tree

Showing 3 changed files with 24 additions and 12 deletions.
diff --git a/docs/caveats.md b/docs/caveats.md
@@ -10,14 +10,18 @@ Babel feature requirements by using [@babel/polyfill](polyfill.md).
 
 You may alternatively/selectively include what you need:
 
-| Feature                     | Requirements                                                                          |
-| --------------------------- | ------------------------------------------------------------------------------------- |
+| Feature                     | Requirements                                                                                            |
+| --------------------------- | ------------------------------------------------------------------------------------------------------- |
 | Async functions, Generators | [regenerator runtime](https://github.com/facebook/regenerator/tree/master/packages/regenerator-runtime) |
-| Array destructuring, For Of | `Symbol`, `prototype[Symbol.iterator]`                                                |
-| Spread                      | `Array.from`                                                                          |
+| Array destructuring, For Of | `Symbol`, `prototype[Symbol.iterator]`                                                                  |
+| Spread                      | `Array.from`                                                                                            |
 
 There is also the `loose` option for some of these plugins.
 
+## Built-ins
+
+Babel assumes that built-ins (e.g. `Array`, `WeakMap` and others), if polyfilled, are modified in a manner that is spec-compliant.
+
 ## Classes
 
 Built-in classes such as `Date`, `Array`, `DOM` etc cannot be properly subclassed

diff --git a/website/versioned_docs/version-6.26.3/caveats.md b/website/versioned_docs/version-6.26.3/caveats.md
@@ -11,14 +11,18 @@ Babel feature requirements by using [babel-polyfill](polyfill.md).
 
 You may alternatively/selectively include what you need:
 
-| Feature                     | Requirements                                                                          |
-| --------------------------- | ------------------------------------------------------------------------------------- |
+| Feature                     | Requirements                                                                                            |
+| --------------------------- | ------------------------------------------------------------------------------------------------------- |
 | Async functions, Generators | [regenerator runtime](https://github.com/facebook/regenerator/tree/master/packages/regenerator-runtime) |
-| Array destructuring, For Of | `Symbol`, `prototype[Symbol.iterator]`                                                |
-| Spread                      | `Array.from`                                                                          |
+| Array destructuring, For Of | `Symbol`, `prototype[Symbol.iterator]`                                                                  |
+| Spread                      | `Array.from`                                                                                            |
 
 There is also the `loose` option for some of these plugins.
 
+## Built-ins
+
+Babel assumes that built-ins (e.g. `Array`, `WeakMap` and others), if polyfilled, are modified in a manner that is spec-compliant.
+
 ## Classes
 
 Built-in classes such as `Date`, `Array`, `DOM` etc cannot be properly subclassed

diff --git a/website/versioned_docs/version-7.0.0/caveats.md b/website/versioned_docs/version-7.0.0/caveats.md
@@ -11,14 +11,18 @@ Babel feature requirements by using [@babel/polyfill](polyfill.md).
 
 You may alternatively/selectively include what you need:
 
-| Feature                     | Requirements                                                                          |
-| --------------------------- | ------------------------------------------------------------------------------------- |
+| Feature                     | Requirements                                                                                            |
+| --------------------------- | ------------------------------------------------------------------------------------------------------- |
 | Async functions, Generators | [regenerator runtime](https://github.com/facebook/regenerator/tree/master/packages/regenerator-runtime) |
-| Array destructuring, For Of | `Symbol`, `prototype[Symbol.iterator]`                                                |
-| Spread                      | `Array.from`                                                                          |
+| Array destructuring, For Of | `Symbol`, `prototype[Symbol.iterator]`                                                                  |
+| Spread                      | `Array.from`                                                                                            |
 
 There is also the `loose` option for some of these plugins.
 
+## Built-ins
+
+Babel assumes that built-ins (e.g. `Array`, `WeakMap` and others), if polyfilled, are modified in a manner that is spec-compliant.
+
 ## Classes
 
 Built-in classes such as `Date`, `Array`, `DOM` etc cannot be properly subclassed