Apply suggestions

boa_cli/src/debug/realm.rs

@@ -1,14 +1,14 @@
 use boa_engine::{object::ObjectInitializer, Context, JsObject, JsResult, JsValue, NativeFunction};
 
 /// Creates a new ECMAScript Realm and returns the global object of the realm.
-fn new_realm(_: &JsValue, _: &[JsValue], _: &mut Context<'_>) -> JsResult<JsValue> {
+fn create(_: &JsValue, _: &[JsValue], _: &mut Context<'_>) -> JsResult<JsValue> {
     let context = &mut Context::default();
 
     Ok(context.global_object().into())
 }
 
 pub(super) fn create_object(context: &mut Context<'_>) -> JsObject {
     ObjectInitializer::new(context)
-        .function(NativeFunction::from_fn_ptr(new_realm), "newRealm", 0)
+        .function(NativeFunction::from_fn_ptr(create), "create", 0)
         .build()
 }

docs/boa_object.md

@@ -148,3 +148,17 @@ Optimizer {
 2
 >>
 ```
+
+## Module `$boa.realm`
+
+This modules contains realm utilities to test cross-realm behaviour.
+
+### `$boa.realm.create`
+
+Creates a new realm with a new set of builtins and returns its global object.
+
+```javascript
+let global = $boa.realm.create();
+
+Object != global.Object // true
+```