shell.cc 15.8 KB
Newer Older
1
// Copyright 2012 the V8 project authors. All rights reserved.
2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
//     * Redistributions of source code must retain the above copyright
//       notice, this list of conditions and the following disclaimer.
//     * Redistributions in binary form must reproduce the above
//       copyright notice, this list of conditions and the following
//       disclaimer in the documentation and/or other materials provided
//       with the distribution.
//     * Neither the name of Google Inc. nor the names of its
//       contributors may be used to endorse or promote products derived
//       from this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

28 29 30
#include <include/v8.h>

#include <include/libplatform/libplatform.h>
31

32
#include <assert.h>
33 34 35
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
36
#include <string.h>
37

38 39 40 41 42 43 44 45
/**
 * This sample program shows how to implement a simple javascript shell
 * based on V8.  This includes initializing V8 with command line options,
 * creating global functions, compiling and executing strings.
 *
 * For a more sophisticated shell, consider using the debug shell D8.
 */

46

47
v8::Local<v8::Context> CreateShellContext(v8::Isolate* isolate);
48 49 50
void RunShell(v8::Local<v8::Context> context, v8::Platform* platform);
int RunMain(v8::Isolate* isolate, v8::Platform* platform, int argc,
            char* argv[]);
51 52
bool ExecuteString(v8::Isolate* isolate, v8::Local<v8::String> source,
                   v8::Local<v8::Value> name, bool print_result,
53
                   bool report_exceptions);
54 55 56 57 58
void Print(const v8::FunctionCallbackInfo<v8::Value>& args);
void Read(const v8::FunctionCallbackInfo<v8::Value>& args);
void Load(const v8::FunctionCallbackInfo<v8::Value>& args);
void Quit(const v8::FunctionCallbackInfo<v8::Value>& args);
void Version(const v8::FunctionCallbackInfo<v8::Value>& args);
59
v8::MaybeLocal<v8::String> ReadFile(v8::Isolate* isolate, const char* name);
60
void ReportException(v8::Isolate* isolate, v8::TryCatch* handler);
61 62


63
static bool run_shell;
64 65


66
int main(int argc, char* argv[]) {
67
  v8::V8::InitializeICUDefaultLocation(argv[0]);
vogelheim's avatar
vogelheim committed
68
  v8::V8::InitializeExternalStartupData(argv[0]);
69 70
  std::unique_ptr<v8::Platform> platform = v8::platform::NewDefaultPlatform();
  v8::V8::InitializePlatform(platform.get());
71
  v8::V8::Initialize();
72
  v8::V8::SetFlagsFromCommandLine(&argc, argv, true);
73
  v8::Isolate::CreateParams create_params;
74 75
  create_params.array_buffer_allocator =
      v8::ArrayBuffer::Allocator::NewDefaultAllocator();
76
  v8::Isolate* isolate = v8::Isolate::New(create_params);
77
  run_shell = (argc == 1);
78 79
  int result;
  {
80
    v8::Isolate::Scope isolate_scope(isolate);
81
    v8::HandleScope handle_scope(isolate);
82
    v8::Local<v8::Context> context = CreateShellContext(isolate);
83
    if (context.IsEmpty()) {
84
      fprintf(stderr, "Error creating context\n");
85 86
      return 1;
    }
87
    v8::Context::Scope context_scope(context);
88 89
    result = RunMain(isolate, platform.get(), argc, argv);
    if (run_shell) RunShell(context, platform.get());
90
  }
cwhan.tunz's avatar
cwhan.tunz committed
91
  isolate->Dispose();
92
  v8::V8::Dispose();
93
  v8::V8::ShutdownPlatform();
94
  delete create_params.array_buffer_allocator;
95 96 97 98
  return result;
}


99 100 101 102 103 104
// Extracts a C string from a V8 Utf8Value.
const char* ToCString(const v8::String::Utf8Value& value) {
  return *value ? *value : "<string conversion failed>";
}


105 106
// Creates a new execution environment containing the built-in
// functions.
107
v8::Local<v8::Context> CreateShellContext(v8::Isolate* isolate) {
108
  // Create a template for the global object.
109
  v8::Local<v8::ObjectTemplate> global = v8::ObjectTemplate::New(isolate);
110
  // Bind the global 'print' function to the C++ Print callback.
111 112 113 114
  global->Set(
      v8::String::NewFromUtf8(isolate, "print", v8::NewStringType::kNormal)
          .ToLocalChecked(),
      v8::FunctionTemplate::New(isolate, Print));
115
  // Bind the global 'read' function to the C++ Read callback.
116 117
  global->Set(v8::String::NewFromUtf8(
                  isolate, "read", v8::NewStringType::kNormal).ToLocalChecked(),
118
              v8::FunctionTemplate::New(isolate, Read));
119
  // Bind the global 'load' function to the C++ Load callback.
120 121
  global->Set(v8::String::NewFromUtf8(
                  isolate, "load", v8::NewStringType::kNormal).ToLocalChecked(),
122
              v8::FunctionTemplate::New(isolate, Load));
123
  // Bind the 'quit' function
124 125
  global->Set(v8::String::NewFromUtf8(
                  isolate, "quit", v8::NewStringType::kNormal).ToLocalChecked(),
126
              v8::FunctionTemplate::New(isolate, Quit));
127
  // Bind the 'version' function
128 129 130 131
  global->Set(
      v8::String::NewFromUtf8(isolate, "version", v8::NewStringType::kNormal)
          .ToLocalChecked(),
      v8::FunctionTemplate::New(isolate, Version));
132

133
  return v8::Context::New(isolate, NULL, global);
134 135 136
}


137 138 139
// The callback that is invoked by v8 whenever the JavaScript 'print'
// function is called.  Prints its arguments on stdout separated by
// spaces and ending with a newline.
140
void Print(const v8::FunctionCallbackInfo<v8::Value>& args) {
141 142
  bool first = true;
  for (int i = 0; i < args.Length(); i++) {
143
    v8::HandleScope handle_scope(args.GetIsolate());
144 145 146 147 148
    if (first) {
      first = false;
    } else {
      printf(" ");
    }
149
    v8::String::Utf8Value str(args.GetIsolate(), args[i]);
150 151
    const char* cstr = ToCString(str);
    printf("%s", cstr);
152 153
  }
  printf("\n");
154
  fflush(stdout);
155 156 157
}


158 159 160
// The callback that is invoked by v8 whenever the JavaScript 'read'
// function is called.  This function loads the content of the file named in
// the argument into a JavaScript string.
161
void Read(const v8::FunctionCallbackInfo<v8::Value>& args) {
162
  if (args.Length() != 1) {
163
    args.GetIsolate()->ThrowException(
164 165
        v8::String::NewFromUtf8(args.GetIsolate(), "Bad parameters",
                                v8::NewStringType::kNormal).ToLocalChecked());
166
    return;
167
  }
168
  v8::String::Utf8Value file(args.GetIsolate(), args[0]);
169
  if (*file == NULL) {
170
    args.GetIsolate()->ThrowException(
171 172
        v8::String::NewFromUtf8(args.GetIsolate(), "Error loading file",
                                v8::NewStringType::kNormal).ToLocalChecked());
173
    return;
174
  }
175 176
  v8::Local<v8::String> source;
  if (!ReadFile(args.GetIsolate(), *file).ToLocal(&source)) {
177
    args.GetIsolate()->ThrowException(
178 179
        v8::String::NewFromUtf8(args.GetIsolate(), "Error loading file",
                                v8::NewStringType::kNormal).ToLocalChecked());
180
    return;
181
  }
182

183
  args.GetReturnValue().Set(source);
184 185
}

186 187 188
// The callback that is invoked by v8 whenever the JavaScript 'load'
// function is called.  Loads, compiles and executes its argument
// JavaScript file.
189
void Load(const v8::FunctionCallbackInfo<v8::Value>& args) {
190
  for (int i = 0; i < args.Length(); i++) {
191
    v8::HandleScope handle_scope(args.GetIsolate());
192
    v8::String::Utf8Value file(args.GetIsolate(), args[i]);
193
    if (*file == NULL) {
194
      args.GetIsolate()->ThrowException(
195 196
          v8::String::NewFromUtf8(args.GetIsolate(), "Error loading file",
                                  v8::NewStringType::kNormal).ToLocalChecked());
197
      return;
198
    }
199 200
    v8::Local<v8::String> source;
    if (!ReadFile(args.GetIsolate(), *file).ToLocal(&source)) {
201
      args.GetIsolate()->ThrowException(
202 203
          v8::String::NewFromUtf8(args.GetIsolate(), "Error loading file",
                                  v8::NewStringType::kNormal).ToLocalChecked());
204
      return;
205
    }
206
    if (!ExecuteString(args.GetIsolate(), source, args[i], false, false)) {
207
      args.GetIsolate()->ThrowException(
208 209
          v8::String::NewFromUtf8(args.GetIsolate(), "Error executing file",
                                  v8::NewStringType::kNormal).ToLocalChecked());
210
      return;
211
    }
212 213 214 215 216 217
  }
}


// The callback that is invoked by v8 whenever the JavaScript 'quit'
// function is called.  Quits.
218
void Quit(const v8::FunctionCallbackInfo<v8::Value>& args) {
219 220
  // If not arguments are given args[0] will yield undefined which
  // converts to the integer value 0.
221 222
  int exit_code =
      args[0]->Int32Value(args.GetIsolate()->GetCurrentContext()).FromMaybe(0);
223 224 225
  fflush(stdout);
  fflush(stderr);
  exit(exit_code);
226 227 228
}


229
void Version(const v8::FunctionCallbackInfo<v8::Value>& args) {
230
  args.GetReturnValue().Set(
231 232
      v8::String::NewFromUtf8(args.GetIsolate(), v8::V8::GetVersion(),
                              v8::NewStringType::kNormal).ToLocalChecked());
233 234 235
}


236
// Reads a file into a v8 string.
237
v8::MaybeLocal<v8::String> ReadFile(v8::Isolate* isolate, const char* name) {
238
  FILE* file = fopen(name, "rb");
239
  if (file == NULL) return v8::MaybeLocal<v8::String>();
240 241

  fseek(file, 0, SEEK_END);
242
  size_t size = ftell(file);
243 244 245 246
  rewind(file);

  char* chars = new char[size + 1];
  chars[size] = '\0';
247 248 249 250
  for (size_t i = 0; i < size;) {
    i += fread(&chars[i], 1, size - i, file);
    if (ferror(file)) {
      fclose(file);
251
      return v8::MaybeLocal<v8::String>();
252
    }
253 254
  }
  fclose(file);
255 256
  v8::MaybeLocal<v8::String> result = v8::String::NewFromUtf8(
      isolate, chars, v8::NewStringType::kNormal, static_cast<int>(size));
257 258 259 260 261
  delete[] chars;
  return result;
}


262
// Process remaining command line arguments and execute files
263 264
int RunMain(v8::Isolate* isolate, v8::Platform* platform, int argc,
            char* argv[]) {
265 266 267 268 269 270 271 272 273
  for (int i = 1; i < argc; i++) {
    const char* str = argv[i];
    if (strcmp(str, "--shell") == 0) {
      run_shell = true;
    } else if (strcmp(str, "-f") == 0) {
      // Ignore any -f flags for compatibility with the other stand-
      // alone JavaScript engines.
      continue;
    } else if (strncmp(str, "--", 2) == 0) {
274 275
      fprintf(stderr,
              "Warning: unknown flag %s.\nTry --help for options\n", str);
276 277
    } else if (strcmp(str, "-e") == 0 && i + 1 < argc) {
      // Execute argument given to -e option directly.
278 279 280 281 282 283 284 285 286
      v8::Local<v8::String> file_name =
          v8::String::NewFromUtf8(isolate, "unnamed",
                                  v8::NewStringType::kNormal).ToLocalChecked();
      v8::Local<v8::String> source;
      if (!v8::String::NewFromUtf8(isolate, argv[++i],
                                   v8::NewStringType::kNormal)
               .ToLocal(&source)) {
        return 1;
      }
287 288 289
      bool success = ExecuteString(isolate, source, file_name, false, true);
      while (v8::platform::PumpMessageLoop(platform, isolate)) continue;
      if (!success) return 1;
290 291
    } else {
      // Use all other arguments as names of files to load and run.
292 293 294 295 296
      v8::Local<v8::String> file_name =
          v8::String::NewFromUtf8(isolate, str, v8::NewStringType::kNormal)
              .ToLocalChecked();
      v8::Local<v8::String> source;
      if (!ReadFile(isolate, str).ToLocal(&source)) {
297
        fprintf(stderr, "Error reading '%s'\n", str);
298 299
        continue;
      }
300 301 302
      bool success = ExecuteString(isolate, source, file_name, false, true);
      while (v8::platform::PumpMessageLoop(platform, isolate)) continue;
      if (!success) return 1;
303 304 305 306 307 308
    }
  }
  return 0;
}


309
// The read-eval-execute loop of the shell.
310
void RunShell(v8::Local<v8::Context> context, v8::Platform* platform) {
311
  fprintf(stderr, "V8 version %s [sample shell]\n", v8::V8::GetVersion());
312
  static const int kBufferSize = 256;
313 314
  // Enter the execution environment before evaluating any code.
  v8::Context::Scope context_scope(context);
315
  v8::Local<v8::String> name(
316 317
      v8::String::NewFromUtf8(context->GetIsolate(), "(shell)",
                              v8::NewStringType::kNormal).ToLocalChecked());
318 319
  while (true) {
    char buffer[kBufferSize];
320
    fprintf(stderr, "> ");
321 322
    char* str = fgets(buffer, kBufferSize, stdin);
    if (str == NULL) break;
323
    v8::HandleScope handle_scope(context->GetIsolate());
324 325 326 327 328
    ExecuteString(
        context->GetIsolate(),
        v8::String::NewFromUtf8(context->GetIsolate(), str,
                                v8::NewStringType::kNormal).ToLocalChecked(),
        name, true, true);
329 330
    while (v8::platform::PumpMessageLoop(platform, context->GetIsolate()))
      continue;
331
  }
332
  fprintf(stderr, "\n");
333 334 335 336
}


// Executes a string within the current v8 context.
337 338
bool ExecuteString(v8::Isolate* isolate, v8::Local<v8::String> source,
                   v8::Local<v8::Value> name, bool print_result,
339
                   bool report_exceptions) {
340
  v8::HandleScope handle_scope(isolate);
341
  v8::TryCatch try_catch(isolate);
342
  v8::ScriptOrigin origin(name);
343 344 345
  v8::Local<v8::Context> context(isolate->GetCurrentContext());
  v8::Local<v8::Script> script;
  if (!v8::Script::Compile(context, source, &origin).ToLocal(&script)) {
346
    // Print errors that happened during compilation.
347
    if (report_exceptions)
348
      ReportException(isolate, &try_catch);
349 350
    return false;
  } else {
351 352
    v8::Local<v8::Value> result;
    if (!script->Run(context).ToLocal(&result)) {
353
      assert(try_catch.HasCaught());
354
      // Print errors that happened during execution.
355
      if (report_exceptions)
356
        ReportException(isolate, &try_catch);
357 358
      return false;
    } else {
359
      assert(!try_catch.HasCaught());
360
      if (print_result && !result->IsUndefined()) {
361 362
        // If all went well and the result wasn't undefined then print
        // the returned value.
363
        v8::String::Utf8Value str(isolate, result);
364 365
        const char* cstr = ToCString(str);
        printf("%s\n", cstr);
366 367 368 369 370
      }
      return true;
    }
  }
}
371 372


373 374
void ReportException(v8::Isolate* isolate, v8::TryCatch* try_catch) {
  v8::HandleScope handle_scope(isolate);
375
  v8::String::Utf8Value exception(isolate, try_catch->Exception());
376
  const char* exception_string = ToCString(exception);
377
  v8::Local<v8::Message> message = try_catch->Message();
378 379 380
  if (message.IsEmpty()) {
    // V8 didn't provide any extra information about this error; just
    // print the exception.
381
    fprintf(stderr, "%s\n", exception_string);
382 383
  } else {
    // Print (filename):(line number): (message).
384 385
    v8::String::Utf8Value filename(isolate,
                                   message->GetScriptOrigin().ResourceName());
386
    v8::Local<v8::Context> context(isolate->GetCurrentContext());
387
    const char* filename_string = ToCString(filename);
388
    int linenum = message->GetLineNumber(context).FromJust();
389
    fprintf(stderr, "%s:%i: %s\n", filename_string, linenum, exception_string);
390
    // Print line of source code.
391
    v8::String::Utf8Value sourceline(
392
        isolate, message->GetSourceLine(context).ToLocalChecked());
393
    const char* sourceline_string = ToCString(sourceline);
394
    fprintf(stderr, "%s\n", sourceline_string);
395
    // Print wavy underline (GetUnderline is deprecated).
396
    int start = message->GetStartColumn(context).FromJust();
397
    for (int i = 0; i < start; i++) {
398
      fprintf(stderr, " ");
399
    }
400
    int end = message->GetEndColumn(context).FromJust();
401
    for (int i = start; i < end; i++) {
402
      fprintf(stderr, "^");
403
    }
404
    fprintf(stderr, "\n");
405 406 407 408
    v8::Local<v8::Value> stack_trace_string;
    if (try_catch->StackTrace(context).ToLocal(&stack_trace_string) &&
        stack_trace_string->IsString() &&
        v8::Local<v8::String>::Cast(stack_trace_string)->Length() > 0) {
409
      v8::String::Utf8Value stack_trace(isolate, stack_trace_string);
410
      const char* stack_trace_string = ToCString(stack_trace);
411
      fprintf(stderr, "%s\n", stack_trace_string);
412
    }
413 414
  }
}