Message.getRegExMatchesByName method (JavaScript API for Office v1.1)

JavaScript API for Office v1.1

Returns string values that match the named regular expression defined in the manifest XML file.

Last modified: June 12, 2014

Applicable Outlook modes

Read

Available in requirement sets

Mailbox

var matches = Office.context.mailbox.item.getRegExMatchesByName(name);

A list of strings containing the strings that match the regular expression defined in the manifest XML file.

The getRegExMatchesByName method returns the strings that match the regular expression defined in the ItemHasRegularExpressionMatch rule element in the manifest XML file with the specified RegExName element value.

If you specify an ItemHasRegularExpressionMatch rule on the body property of an item, the regular expression should further filter the body and should not attempt to return the entire body of the item. Using a regular expression such as .* to obtain the entire body of an item does not always return the expected results.

App types

Mail app

Supported clients

Outlook 2013, Outlook 2013 SP1, Outlook 2013 RT, Outlook Web App, and OWA for Devices

Library

Office.js

Namespace

Office

Show:
© 2014 Microsoft