script.go 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112
  1. package otto
  2. import (
  3. "bytes"
  4. "encoding/gob"
  5. "errors"
  6. )
  7. var ErrVersion = errors.New("version mismatch")
  8. var scriptVersion = "2014-04-13/1"
  9. // Script is a handle for some (reusable) JavaScript.
  10. // Passing a Script value to a run method will evaluate the JavaScript.
  11. //
  12. type Script struct {
  13. version string
  14. program *_nodeProgram
  15. filename string
  16. src string
  17. }
  18. // Compile will parse the given source and return a Script value or nil and
  19. // an error if there was a problem during compilation.
  20. //
  21. // script, err := vm.Compile("", `var abc; if (!abc) abc = 0; abc += 2; abc;`)
  22. // vm.Run(script)
  23. //
  24. func (self *Otto) Compile(filename string, src interface{}) (*Script, error) {
  25. return self.CompileWithSourceMap(filename, src, nil)
  26. }
  27. // CompileWithSourceMap does the same thing as Compile, but with the obvious
  28. // difference of applying a source map.
  29. func (self *Otto) CompileWithSourceMap(filename string, src, sm interface{}) (*Script, error) {
  30. program, err := self.runtime.parse(filename, src, sm)
  31. if err != nil {
  32. return nil, err
  33. }
  34. cmpl_program := cmpl_parse(program)
  35. script := &Script{
  36. version: scriptVersion,
  37. program: cmpl_program,
  38. filename: filename,
  39. src: program.File.Source(),
  40. }
  41. return script, nil
  42. }
  43. func (self *Script) String() string {
  44. return "// " + self.filename + "\n" + self.src
  45. }
  46. // MarshalBinary will marshal a script into a binary form. A marshalled script
  47. // that is later unmarshalled can be executed on the same version of the otto runtime.
  48. //
  49. // The binary format can change at any time and should be considered unspecified and opaque.
  50. //
  51. func (self *Script) marshalBinary() ([]byte, error) {
  52. var bfr bytes.Buffer
  53. encoder := gob.NewEncoder(&bfr)
  54. err := encoder.Encode(self.version)
  55. if err != nil {
  56. return nil, err
  57. }
  58. err = encoder.Encode(self.program)
  59. if err != nil {
  60. return nil, err
  61. }
  62. err = encoder.Encode(self.filename)
  63. if err != nil {
  64. return nil, err
  65. }
  66. err = encoder.Encode(self.src)
  67. if err != nil {
  68. return nil, err
  69. }
  70. return bfr.Bytes(), nil
  71. }
  72. // UnmarshalBinary will vivify a marshalled script into something usable. If the script was
  73. // originally marshalled on a different version of the otto runtime, then this method
  74. // will return an error.
  75. //
  76. // The binary format can change at any time and should be considered unspecified and opaque.
  77. func (self *Script) unmarshalBinary(data []byte) (err error) {
  78. decoder := gob.NewDecoder(bytes.NewReader(data))
  79. defer func() {
  80. if err != nil {
  81. self.version = ""
  82. self.program = nil
  83. self.filename = ""
  84. self.src = ""
  85. }
  86. }()
  87. if err = decoder.Decode(&self.version); err != nil {
  88. return err
  89. }
  90. if self.version != scriptVersion {
  91. return ErrVersion
  92. }
  93. if err = decoder.Decode(&self.program); err != nil {
  94. return err
  95. }
  96. if err = decoder.Decode(&self.filename); err != nil {
  97. return err
  98. }
  99. return decoder.Decode(&self.src)
  100. }