mirror/otto
1
0
Fork 0
mirror of https://github.com/robertkrimen/otto synced 2025-10-26 20:28:49 +08:00
Code Issues Releases Wiki Activity

Edit documentation

Browse Source
This commit is contained in:
Robert Krimen
2013-05-19 22:26:36 -07:00
parent 18630616eb
commit 10bb73298b
2 changed files with 25 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
otto.go
View File

@@ -142,7 +142,7 @@ func Run(source string) (*Otto, Value, error) {
// Run will run the given source (parsing it first), returning the resulting value and error (if any)
//
// If the runtime is unable to parse the source, then this function will return undefined and the parse error (nothing
// If the runtime is unable to parse source, then this function will return undefined and the parse error (nothing
// will be evaluated in this case).
func (self Otto) Run(source string) (Value, error) {
return self.runtime.runSafe(source)
@@ -150,7 +150,7 @@ func (self Otto) Run(source string) (Value, error) {
// Get the value of the top-level binding of the given name.
//
// If there is an error (like the binding not existing), then the value
// If there is an error (like the binding does not exist), then the value
// will be undefined.
func (self Otto) Get(name string) (Value, error) {
value := UndefinedValue()
@@ -169,8 +169,8 @@ func (self Otto) getValue(name string) Value {
// Set will automatically apply ToValue to the given value in order
// to convert it to a JavaScript value (type Value).
//
// If there is an error (like the binding being read-only, or the ToValue conversion
// failing), then an error is returned.
// If there is an error (like the binding is read-only, or the ToValue conversion
// fails), then an error is returned.
//
// If the top-level binding does not exist, it will be created.
func (self Otto) Set(name string, value interface{}) error {
@@ -195,22 +195,22 @@ func (self Otto) setValue(name string, value Value) {
// WARNING: 2013-05-19: This function is rough, and is in beta.
//
// If this is nil, then some special handling takes place to determine the proper
// this value, falling back to a "standard" invocation if necessary (calling the
// function which is the result of evaluating the source with a this of undefined).
// this value, falling back to a "standard" invocation if necessary (where this is
// undefined).
//
// If source begins with "new " (A lowercase new followed by a space), then
// Call will invoke the function constructor rather than performing a function call.
// In this case, the this argument has no effect.
//
// // value is a String object
// value, _ := Otto.Call("Object", nil, "Hello, World.")
//
// // Likewise...
// value, _ := Otto.Call("new Object", nil, "Hello, World.")
//
// // This will perform a concat on the given array and return the result
// // value is [ 1, 2, 3, undefined, 4, 5, 6, 7, "abc" ]
// value, _ := Otto.Call(`[ 1, 2, 3, undefined, 4 ].concat`, nil, 5, 6, 7, "abc")
// // value is a String object 
// value, _ := Otto.Call("Object", nil, "Hello, World.") 
// 
// // Likewise... 
// value, _ := Otto.Call("new Object", nil, "Hello, World.") 
// 
// // This will perform a concat on the given array and return the result 
// // value is [ 1, 2, 3, undefined, 4, 5, 6, 7, "abc" ] 
// value, _ := Otto.Call(`[ 1, 2, 3, undefined, 4 ].concat`, nil, 5, 6, 7, "abc") 
//
func (self Otto) Call(source string, this interface{}, argumentList ...interface{}) (Value, error) {
@@ -318,7 +318,8 @@ func _newObject(object *_object, value Value) *Object {
// Call the method specified by the given name, using self as the this value.
// It is essentially equivalent to:
//
// return self.Get(name).Call(self, argumentList)
// var method, _ := self.Get(name)
// method.Call(self, argumentList...)
//
// An undefined value and an error will result if:
//