http-post-message

WebJar for http-post-message

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

http-post-message
Last Version

Last Version

0.2.4
Release Date

Release Date

Type

Type

jar
Description

Description

http-post-message
WebJar for http-post-message
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/Microsoft/http-post-message

Download http-post-message

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/http-post-message/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>http-post-message</artifactId>
    <version>0.2.4</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/http-post-message/
implementation 'org.webjars.npm:http-post-message:0.2.4'
// https://jarcasting.com/artifacts/org.webjars.npm/http-post-message/
implementation ("org.webjars.npm:http-post-message:0.2.4")
'org.webjars.npm:http-post-message:jar:0.2.4'
<dependency org="org.webjars.npm" name="http-post-message" rev="0.2.4">
  <artifact name="http-post-message" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='http-post-message', version='0.2.4')
)
libraryDependencies += "org.webjars.npm" % "http-post-message" % "0.2.4"
[org.webjars.npm/http-post-message "0.2.4"]

Dependencies

compile (1)

Group / Artifact Type Version
org.webjars.npm : es6-promise jar [3.2.1,4)

Project Modules

There are no modules declared in this project.

htt-post-message

Travis branch npm Total Downloads Monthly Downloads GitHub tag

A generic messaging component to send HTTP style message payloads over the window.postMessage API. Requires an implementation of window postMessage proxy such as 'window-post-message-proxy'.

Documentation:

https://microsoft.github.io/http-post-message

Installation

npm install --save http-post-message

Usage

The HttpPostMessage takes in an object that implements the IPostMessage interface which is just one method postMessage which returns a Promise.

In the case below we created a mock postMessage proxy, but in normal usage you would likely use the accompanying library window-post-message-proxy and configure it to handle http messages as shown in the section below

import * as hpm from 'http-post-message';

const stubWindowPostMessageProxy: hpm.IPostMessage = {
  postMessage(message: any) {
    console.log(message);
    return Promise.resolve(message):
  }
}

const httpPostMessage = new hpm.HttpPostMessage(stubWindowPostMessageProxy);

httpPostMessage.get('target/path')
  .then(response => {
    ...
  });

Methods

The object supports all the standard http methods, get, post, put, patch, and delete. You can also send an IRequest object directly to the lower-level send method.

Determining promise resolution state

The promise returned by the request will be fulfulled or rejected depending on how the instance of WindowPostMessageProxy provided to the constructor was configured.

Since we intend to use HTTP semantics, this library comes with static methods that can be provided to the WPMP class during construction as seen below:

import * as wpmp from 'window-post-message-proxy';
import * as hpm from 'http-post-message';

const windowPostMessageProxy = new wpmp.WindowPostMessageProxy({
  processTrackingProperties: {
      addTrackingProperties: hpm.HttpPostMessage.addTrackingProperties,
      getTrackingProperties: hpm.HttpPostMessage.getTrackingProperties,
  },
  isErrorMessage: hpm.HttpPostMessage.isErrorMessage
});

const httpPostMessage = new hpm.HttpPostMessage(windowPostMessageProxy);

Default Headers and Default Window

You may specify default headers and default target window to be sent with every request by supplying them during construction.

Providing the default target window in the constructor means you do not have to specify it in each individual request, but it can be over written to allow a single instance of HPM to communicate with multiple windows.

import * as hpm from 'http-post-message';

...

const httpPostMessage = new hpm.HttpPostMessage(wpmp, {
    'x-sdk-type': sdkType,
    'x-sdk-version': sdkVersion
  }, defaultTargetWindow);
});
org.webjars.npm

Microsoft

Open source projects and samples from Microsoft

Versions

Version
0.2.4