OLD | NEW |
1 // Copyright 2012 the V8 project authors. All rights reserved. | 1 // Copyright 2012 the V8 project authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 /** \mainpage V8 API Reference Guide | 5 /** \mainpage V8 API Reference Guide |
6 * | 6 * |
7 * V8 is Google's open source JavaScript engine. | 7 * V8 is Google's open source JavaScript engine. |
8 * | 8 * |
9 * This set of documents provides reference material generated from the | 9 * This set of documents provides reference material generated from the |
10 * V8 header file, include/v8.h. | 10 * V8 header file, include/v8.h. |
(...skipping 5540 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
5551 /** | 5551 /** |
5552 * Returns CPU profiler for this isolate. Will return NULL unless the isolate | 5552 * Returns CPU profiler for this isolate. Will return NULL unless the isolate |
5553 * is initialized. It is the embedder's responsibility to stop all CPU | 5553 * is initialized. It is the embedder's responsibility to stop all CPU |
5554 * profiling activities if it has started any. | 5554 * profiling activities if it has started any. |
5555 */ | 5555 */ |
5556 CpuProfiler* GetCpuProfiler(); | 5556 CpuProfiler* GetCpuProfiler(); |
5557 | 5557 |
5558 /** Returns true if this isolate has a current context. */ | 5558 /** Returns true if this isolate has a current context. */ |
5559 bool InContext(); | 5559 bool InContext(); |
5560 | 5560 |
5561 /** Returns the context that is on the top of the stack. */ | 5561 /** |
| 5562 * Returns the context of the currently running JavaScript, or the context |
| 5563 * on the top of the stack if no JavaScript is running. |
| 5564 */ |
5562 Local<Context> GetCurrentContext(); | 5565 Local<Context> GetCurrentContext(); |
5563 | 5566 |
5564 /** | 5567 /** |
5565 * Returns the context of the calling JavaScript code. That is the | 5568 * Returns the context of the calling JavaScript code. That is the |
5566 * context of the top-most JavaScript frame. If there are no | 5569 * context of the top-most JavaScript frame. If there are no |
5567 * JavaScript frames an empty handle is returned. | 5570 * JavaScript frames an empty handle is returned. |
5568 */ | 5571 */ |
5569 Local<Context> GetCallingContext(); | 5572 V8_DEPRECATE_SOON( |
| 5573 "Calling context concept is not compatible with tail calls, and will be " |
| 5574 "removed.", |
| 5575 Local<Context> GetCallingContext()); |
5570 | 5576 |
5571 /** Returns the last entered context. */ | 5577 /** Returns the last context entered through V8's C++ API. */ |
5572 Local<Context> GetEnteredContext(); | 5578 Local<Context> GetEnteredContext(); |
5573 | 5579 |
5574 /** | 5580 /** |
5575 * Schedules an exception to be thrown when returning to JavaScript. When an | 5581 * Schedules an exception to be thrown when returning to JavaScript. When an |
5576 * exception has been scheduled it is illegal to invoke any JavaScript | 5582 * exception has been scheduled it is illegal to invoke any JavaScript |
5577 * operation; the caller must return immediately and only after the exception | 5583 * operation; the caller must return immediately and only after the exception |
5578 * has been handled does it become legal to invoke JavaScript operations. | 5584 * has been handled does it become legal to invoke JavaScript operations. |
5579 */ | 5585 */ |
5580 Local<Value> ThrowException(Local<Value> exception); | 5586 Local<Value> ThrowException(Local<Value> exception); |
5581 | 5587 |
(...skipping 2851 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
8433 */ | 8439 */ |
8434 | 8440 |
8435 | 8441 |
8436 } // namespace v8 | 8442 } // namespace v8 |
8437 | 8443 |
8438 | 8444 |
8439 #undef TYPE_CHECK | 8445 #undef TYPE_CHECK |
8440 | 8446 |
8441 | 8447 |
8442 #endif // V8_H_ | 8448 #endif // V8_H_ |
OLD | NEW |