Gecko [ oric.aiou.edu.pk ]

Name	Size	Permission
aliased_buffer.h	6.42 KB	-rw-r--r--
async_wrap-inl.h	3.33 KB	-rw-r--r--
async_wrap.h	9.16 KB	-rw-r--r--
base64.h	5.82 KB	-rw-r--r--
base_object-inl.h	4.02 KB	-rw-r--r--
base_object.h	4.43 KB	-rw-r--r--
connect_wrap.h	617 B	-rw-r--r--
connection_wrap.h	699 B	-rw-r--r--
debug_utils.h	4.29 KB	-rw-r--r--
env-inl.h	30.64 KB	-rw-r--r--
env.h	46.48 KB	-rw-r--r--
handle_wrap.h	3.91 KB	-rw-r--r--
inspector_agent.h	4.13 KB	-rw-r--r--
inspector_io.h	2.63 KB	-rw-r--r--
inspector_socket.h	1.46 KB	-rw-r--r--
inspector_socket_server.h	3.21 KB	-rw-r--r--
js_stream.h	1.58 KB	-rw-r--r--
memory_tracker-inl.h	10.83 KB	-rw-r--r--
memory_tracker.h	9.96 KB	-rw-r--r--
module_wrap.h	3.07 KB	-rw-r--r--
node.h	35.16 KB	-rw-r--r--
node_api.h	35.44 KB	-rw-r--r--
node_api_types.h	4.16 KB	-rw-r--r--
node_buffer.h	3.4 KB	-rw-r--r--
node_code_cache.h	432 B	-rw-r--r--
node_constants.h	3.11 KB	-rw-r--r--
node_context_data.h	1.14 KB	-rw-r--r--
node_contextify.h	4.81 KB	-rw-r--r--
node_counters.h	2.37 KB	-rw-r--r--
node_crypto.h	23.92 KB	-rw-r--r--
node_crypto_bio.h	5.44 KB	-rw-r--r--
node_crypto_clienthello-inl.h	2.62 KB	-rw-r--r--
node_crypto_clienthello.h	4 KB	-rw-r--r--
node_crypto_groups.h	23.12 KB	-rw-r--r--
node_dtrace.h	2.91 KB	-rw-r--r--
node_errors.h	6.06 KB	-rw-r--r--
node_file.h	10.16 KB	-rw-r--r--
node_http2.h	47.76 KB	-rw-r--r--
node_http2_state.h	4.72 KB	-rw-r--r--
node_i18n.h	2.4 KB	-rw-r--r--
node_internals.h	28.47 KB	-rw-r--r--
node_javascript.h	1.72 KB	-rw-r--r--
node_messaging.h	8.38 KB	-rw-r--r--
node_mutex.h	4.42 KB	-rw-r--r--
node_object_wrap.h	3.7 KB	-rw-r--r--
node_options-inl.h	14.78 KB	-rw-r--r--
node_options.h	12.25 KB	-rw-r--r--
node_perf.h	3.64 KB	-rw-r--r--
node_perf_common.h	3 KB	-rw-r--r--
node_persistent.h	936 B	-rw-r--r--
node_platform.h	5.14 KB	-rw-r--r--
node_revert.h	2.21 KB	-rw-r--r--
node_root_certs.h	223.29 KB	-rw-r--r--
node_stat_watcher.h	2.15 KB	-rw-r--r--
node_url.h	6.16 KB	-rw-r--r--
node_version.h	3.79 KB	-rw-r--r--
node_watchdog.h	3.03 KB	-rw-r--r--
node_win32_etw_provider-inl.h	11.67 KB	-rw-r--r--
node_win32_etw_provider.h	3.67 KB	-rw-r--r--
node_win32_perfctr_provider.h	2.14 KB	-rw-r--r--
node_worker.h	2.88 KB	-rw-r--r--
pipe_wrap.h	2.62 KB	-rw-r--r--
req_wrap-inl.h	5.44 KB	-rw-r--r--
req_wrap.h	1.87 KB	-rw-r--r--
sharedarraybuffer_metadata.h	2.34 KB	-rw-r--r--
spawn_sync.h	6.82 KB	-rw-r--r--
stream_base-inl.h	14.08 KB	-rw-r--r--
stream_base.h	13.46 KB	-rw-r--r--
stream_pipe.h	2 KB	-rw-r--r--
stream_wrap.h	4.03 KB	-rw-r--r--
string_bytes.h	5.14 KB	-rw-r--r--
string_decoder-inl.h	876 B	-rw-r--r--
string_decoder.h	1.5 KB	-rw-r--r--
string_search.h	20.53 KB	-rw-r--r--
tcp_wrap.h	3.59 KB	-rw-r--r--
tls_wrap.h	6.61 KB	-rw-r--r--
tty_wrap.h	2.22 KB	-rw-r--r--
udp_wrap.h	4.12 KB	-rw-r--r--
util-inl.h	14.06 KB	-rw-r--r--
util.h	15.9 KB	-rw-r--r--
v8abbr.h	5.03 KB	-rw-r--r--

Code Editor : node_messaging.h

#ifndef SRC_NODE_MESSAGING_H_
#define SRC_NODE_MESSAGING_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include "env.h"
#include "node_mutex.h"
#include "sharedarraybuffer_metadata.h"
#include <list>

namespace node {
namespace worker {

class MessagePortData;
class MessagePort;

// Represents a single communication message.
class Message : public MemoryRetainer {
 public:
  explicit Message(MallocedBuffer<char>&& payload = MallocedBuffer<char>());

Message(Message&& other) = default;
  Message& operator=(Message&& other) = default;
  Message& operator=(const Message&) = delete;
  Message(const Message&) = delete;

// Deserialize the contained JS value. May only be called once, and only
  // after Serialize() has been called (e.g. by another thread).
  v8::MaybeLocal<v8::Value> Deserialize(Environment* env,
                                        v8::Local<v8::Context> context);

// Serialize a JS value, and optionally transfer objects, into this message.
  // The Message object retains ownership of all transferred objects until
  // deserialization.
  // The source_port parameter, if provided, will make Serialize() throw a
  // "DataCloneError" DOMException if source_port is found in transfer_list.
  v8::Maybe<bool> Serialize(Environment* env,
                            v8::Local<v8::Context> context,
                            v8::Local<v8::Value> input,
                            v8::Local<v8::Value> transfer_list,
                            v8::Local<v8::Object> source_port =
                                v8::Local<v8::Object>());

// Internal method of Message that is called when a new SharedArrayBuffer
  // object is encountered in the incoming value's structure.
  void AddSharedArrayBuffer(SharedArrayBufferMetadataReference ref);
  // Internal method of Message that is called once serialization finishes
  // and that transfers ownership of `data` to this message.
  void AddMessagePort(std::unique_ptr<MessagePortData>&& data);

// The MessagePorts that will be transferred, as recorded by Serialize().
  // Used for warning user about posting the target MessagePort to itself,
  // which will as a side effect destroy the communication channel.
  const std::vector<std::unique_ptr<MessagePortData>>& message_ports() const {
    return message_ports_;
  }

void MemoryInfo(MemoryTracker* tracker) const override;

SET_MEMORY_INFO_NAME(Message)
  SET_SELF_SIZE(Message)

private:
  MallocedBuffer<char> main_message_buf_;
  std::vector<MallocedBuffer<char>> array_buffer_contents_;
  std::vector<SharedArrayBufferMetadataReference> shared_array_buffers_;
  std::vector<std::unique_ptr<MessagePortData>> message_ports_;

friend class MessagePort;
};

// This contains all data for a `MessagePort` instance that is not tied to
// a specific Environment/Isolate/event loop, for easier transfer between those.
class MessagePortData : public MemoryRetainer {
 public:
  explicit MessagePortData(MessagePort* owner);
  ~MessagePortData();

MessagePortData(MessagePortData&& other) = delete;
  MessagePortData& operator=(MessagePortData&& other) = delete;
  MessagePortData(const MessagePortData& other) = delete;
  MessagePortData& operator=(const MessagePortData& other) = delete;

// Add a message to the incoming queue and notify the receiver.
  // This may be called from any thread.
  void AddToIncomingQueue(Message&& message);

// Returns true if and only this MessagePort is currently not entangled
  // with another message port.
  bool IsSiblingClosed() const;

// Turns `a` and `b` into siblings, i.e. connects the sending side of one
  // to the receiving side of the other. This is not thread-safe.
  static void Entangle(MessagePortData* a, MessagePortData* b);

// Removes any possible sibling. This is thread-safe (it acquires both
  // `sibling_mutex_` and `mutex_`), and has to be because it is called once
  // the corresponding JS handle handle wants to close
  // which can happen on either side of a worker.
  void Disentangle();

void MemoryInfo(MemoryTracker* tracker) const override;

SET_MEMORY_INFO_NAME(MessagePortData)
  SET_SELF_SIZE(MessagePortData)

private:
  // After disentangling this message port, the owner handle (if any)
  // is asynchronously triggered, so that it can close down naturally.
  void PingOwnerAfterDisentanglement();

// This mutex protects all fields below it, with the exception of
  // sibling_.
  mutable Mutex mutex_;
  bool receiving_messages_ = false;
  std::list<Message> incoming_messages_;
  MessagePort* owner_ = nullptr;
  // This mutex protects the sibling_ field and is shared between two entangled
  // MessagePorts. If both mutexes are acquired, this one needs to be
  // acquired first.
  std::shared_ptr<Mutex> sibling_mutex_ = std::make_shared<Mutex>();
  MessagePortData* sibling_ = nullptr;

friend class MessagePort;
};

// A message port that receives messages from other threads, including
// the uv_async_t handle that is used to notify the current event loop of
// new incoming messages.
class MessagePort : public HandleWrap {
 public:
  // Create a new MessagePort. The `context` argument specifies the Context
  // instance that is used for creating the values emitted from this port.
  MessagePort(Environment* env,
              v8::Local<v8::Context> context,
              v8::Local<v8::Object> wrap);
  ~MessagePort();

// Create a new message port instance, optionally over an existing
  // `MessagePortData` object.
  static MessagePort* New(Environment* env,
                          v8::Local<v8::Context> context,
                          std::unique_ptr<MessagePortData> data = nullptr);

// Send a message, i.e. deliver it into the sibling's incoming queue.
  // If this port is closed, or if there is no sibling, this message is
  // serialized with transfers, then silently discarded.
  v8::Maybe<bool> PostMessage(Environment* env,
                              v8::Local<v8::Value> message,
                              v8::Local<v8::Value> transfer);
  // Deliver a single message into this port's incoming queue.
  void AddToIncomingQueue(Message&& message);

// Start processing messages on this port as a receiving end.
  void Start();
  // Stop processing messages on this port as a receiving end.
  void Stop();
  // Stop processing messages on this port as a receiving end,
  // and stop the event loop that this port is associated with.
  void StopEventLoop();

static void New(const v8::FunctionCallbackInfo<v8::Value>& args);
  static void PostMessage(const v8::FunctionCallbackInfo<v8::Value>& args);
  static void Start(const v8::FunctionCallbackInfo<v8::Value>& args);
  static void Stop(const v8::FunctionCallbackInfo<v8::Value>& args);
  static void Drain(const v8::FunctionCallbackInfo<v8::Value>& args);

// Turns `a` and `b` into siblings, i.e. connects the sending side of one
  // to the receiving side of the other. This is not thread-safe.
  static void Entangle(MessagePort* a, MessagePort* b);
  static void Entangle(MessagePort* a, MessagePortData* b);

// Detach this port's data for transferring. After this, the MessagePortData
  // is no longer associated with this handle, although it can still receive
  // messages.
  std::unique_ptr<MessagePortData> Detach();

bool IsSiblingClosed() const;
  void Close(
      v8::Local<v8::Value> close_callback = v8::Local<v8::Value>()) override;

// Returns true if either data_ has been freed, or if the handle is being
  // closed. Equivalent to the [[Detached]] internal slot in the HTML Standard.
  //
  // If checking if a JavaScript MessagePort object is detached, this method
  // alone is often not enough, since the backing C++ MessagePort object may
  // have been deleted already. For all intents and purposes, an object with a
  // NULL pointer to the C++ MessagePort object is also detached.
  inline bool IsDetached() const;

void MemoryInfo(MemoryTracker* tracker) const override {
    tracker->TrackField("data", data_);
  }

SET_MEMORY_INFO_NAME(MessagePort)
  SET_SELF_SIZE(MessagePort)

private:
  void OnClose() override;
  void OnMessage();
  void TriggerAsync();
  inline uv_async_t* async();

std::unique_ptr<MessagePortData> data_ = nullptr;
  bool stop_event_loop_ = false;

friend class MessagePortData;
};

v8::MaybeLocal<v8::Function> GetMessagePortConstructor(
    Environment* env, v8::Local<v8::Context> context);

}  // namespace worker
}  // namespace node

#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#endif  // SRC_NODE_MESSAGING_H_

${this.title}

Code Editor : node_messaging.h