Provide getReport API to return the contents of node-report.

README.md

@@ -28,6 +28,14 @@ application.
 var nodereport = require('node-report');
 nodereport.triggerReport();
 ```
+The content of a report can also be returned as a JavaScript string via an
+API call from a JavaScript application.
+
+```js
+var nodereport = require('nodereport');
+var report_str = nodereport.getReport();
+console.log(report_str);
+```
 The API can be used without adding the automatic exception and fatal error
 hooks and the signal handler, as follows:
 

index.js

@@ -7,6 +7,7 @@ const options = process.env.NODEREPORT_EVENTS || 'exception+fatalerror+signal+ap
 api.setEvents(options);
 
 exports.triggerReport = api.triggerReport;
+exports.getReport = api.getReport;
 exports.setEvents = api.setEvents;
 exports.setCoreDump = api.setCoreDump;
 exports.setSignal = api.setSignal;

src/module.cc

@@ -1,5 +1,6 @@
 #include "node_report.h"
 #include <nan.h>
+#include <sstream>
 
 namespace nodereport {
 
@@ -67,6 +68,20 @@ NAN_METHOD(TriggerReport) {
   }
 }
 
+/*******************************************************************************
+ * External JavaScript API for returning a report
+ *
+ ******************************************************************************/
+NAN_METHOD(GetReport) {
+  Nan::HandleScope scope;
+  v8::Isolate* isolate = info.GetIsolate();
+  std::ostringstream out;
+
+  GetNodeReport(isolate, kJavaScript, "JavaScript API", __func__, out);
+  // Return value is the contents of a report as a string.
+  info.GetReturnValue().Set(Nan::New(out.str()).ToLocalChecked());
+}
+
 /*******************************************************************************
  * External JavaScript APIs for node-report configuration
  *
@@ -392,6 +407,8 @@ void Initialize(v8::Local<v8::Object> exports) {
 
   exports->Set(Nan::New("triggerReport").ToLocalChecked(),
                Nan::New<v8::FunctionTemplate>(TriggerReport)->GetFunction());
+  exports->Set(Nan::New("getReport").ToLocalChecked(),
+               Nan::New<v8::FunctionTemplate>(GetReport)->GetFunction());
   exports->Set(Nan::New("setEvents").ToLocalChecked(),
                Nan::New<v8::FunctionTemplate>(SetEvents)->GetFunction());
   exports->Set(Nan::New("setSignal").ToLocalChecked(),