@microsoft/1ds-core-js 4.0.1 → 4.0.2-nightly3.2307-25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -28
- package/bundle/es5/{ms.core-4.0.1.gbl.js → ms.core-4.0.2-nightly3.2307-25.gbl.js} +392 -373
- package/bundle/es5/ms.core-4.0.2-nightly3.2307-25.gbl.js.map +1 -0
- package/bundle/es5/ms.core-4.0.2-nightly3.2307-25.gbl.min.js +7 -0
- package/bundle/es5/ms.core-4.0.2-nightly3.2307-25.gbl.min.js.map +1 -0
- package/bundle/es5/ms.core-4.0.2-nightly3.2307-25.integrity.json +46 -0
- package/bundle/es5/{ms.core-4.0.1.js → ms.core-4.0.2-nightly3.2307-25.js} +392 -373
- package/bundle/es5/ms.core-4.0.2-nightly3.2307-25.js.map +1 -0
- package/bundle/es5/ms.core-4.0.2-nightly3.2307-25.min.js +7 -0
- package/bundle/es5/ms.core-4.0.2-nightly3.2307-25.min.js.map +1 -0
- package/bundle/es5/ms.core.gbl.js +391 -372
- package/bundle/es5/ms.core.gbl.js.map +1 -1
- package/bundle/es5/ms.core.gbl.min.js +2 -2
- package/bundle/es5/ms.core.gbl.min.js.map +1 -1
- package/bundle/es5/ms.core.integrity.json +17 -17
- package/bundle/es5/ms.core.js +391 -372
- package/bundle/es5/ms.core.js.map +1 -1
- package/bundle/es5/ms.core.min.js +2 -2
- package/bundle/es5/ms.core.min.js.map +1 -1
- package/dist/es5/ms.core.js +389 -370
- package/dist/es5/ms.core.js.map +1 -1
- package/dist/es5/ms.core.min.js +2 -2
- package/dist/es5/ms.core.min.js.map +1 -1
- package/dist-es5/AppInsightsCore.js +18 -14
- package/dist-es5/AppInsightsCore.js.map +1 -1
- package/dist-es5/BaseCore.js +8 -8
- package/dist-es5/BaseCore.js.map +1 -1
- package/dist-es5/DataModels.js +1 -1
- package/dist-es5/Enums.js +2 -2
- package/dist-es5/Enums.js.map +1 -1
- package/dist-es5/Index.js +7 -7
- package/dist-es5/Index.js.map +1 -1
- package/dist-es5/InternalConstants.js +1 -1
- package/dist-es5/Utils.js +20 -19
- package/dist-es5/Utils.js.map +1 -1
- package/dist-es5/ValueSanitizer.js +29 -28
- package/dist-es5/ValueSanitizer.js.map +1 -1
- package/dist-es5/__DynamicConstants.js +28 -0
- package/dist-es5/__DynamicConstants.js.map +1 -0
- package/package.json +41 -22
- package/types/1ds-core-js.d.ts +14 -22
- package/types/1ds-core-js.namespaced.d.ts +11 -19
- package/bundle/es5/ms.core-4.0.1.gbl.js.map +0 -1
- package/bundle/es5/ms.core-4.0.1.gbl.min.js +0 -7
- package/bundle/es5/ms.core-4.0.1.gbl.min.js.map +0 -1
- package/bundle/es5/ms.core-4.0.1.integrity.json +0 -46
- package/bundle/es5/ms.core-4.0.1.js.map +0 -1
- package/bundle/es5/ms.core-4.0.1.min.js +0 -7
- package/bundle/es5/ms.core-4.0.1.min.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,13 +1,3 @@
|
|
|
1
|
-
---
|
|
2
|
-
ArtifactType: npm package, javascript from CDN.
|
|
3
|
-
Documentation: https://1dsdocs.azurewebsites.net/getting-started/javascript-getting_started.html
|
|
4
|
-
Language: typescript
|
|
5
|
-
Platform: various
|
|
6
|
-
Stackoverflow: N/A
|
|
7
|
-
Tags: 1DSJSSDK
|
|
8
|
-
ms.reviewedAt: 02/21/2019
|
|
9
|
-
ms.reviewedBy: ramthi
|
|
10
|
-
---
|
|
11
1
|
# Microsoft 1DS Web SDK Core
|
|
12
2
|
|
|
13
3
|
## Description
|
|
@@ -16,7 +6,7 @@ ms.reviewedBy: ramthi
|
|
|
16
6
|
|
|
17
7
|
## npm
|
|
18
8
|
|
|
19
|
-
Packages available [here](https://
|
|
9
|
+
Packages available [here](https://www.npmjs.com/package/@microsoft/1ds-core-js).
|
|
20
10
|
|
|
21
11
|
## Basic Usage
|
|
22
12
|
|
|
@@ -37,7 +27,7 @@ appInsightsCore.initialize(coreConfig, []);
|
|
|
37
27
|
|
|
38
28
|
## Configuration
|
|
39
29
|
|
|
40
|
-
### [IExtendedConfiguration](https://
|
|
30
|
+
### [IExtendedConfiguration](https://microsoft.github.io/ApplicationInsights-JS/webSdk/1ds-core-js/interfaces/IExtendedConfiguration.html)
|
|
41
31
|
|
|
42
32
|
| Config | Description | Type
|
|
43
33
|
|----------------|----------------------------------------|----|
|
|
@@ -58,21 +48,21 @@ appInsightsCore.initialize(coreConfig, []);
|
|
|
58
48
|
| cookiePath | Custom cookie path. This is helpful if you want to share Application Insights cookies behind an application gateway.<br>If `cookieCfg.path` is defined it will take precedence over this value. | alias for [`cookieCfg.path`](#ICookieMgrConfig)<br>[Optional]<br>(Since 3.1.0) |
|
|
59
49
|
| anonCookieName |Name of the Anon cookie. The value will be set in the qsp header to collector requests. Collector will use this value to look for specific cookie to use for anid property.|string
|
|
60
50
|
| enablePerfMgr | [Optional] When enabled (true) this will create local perfEvents for code that has been instrumented to emit perfEvents (via the doPerf() helper). This can be used to identify performance issues within the SDK based on your usage or optionally within your own instrumented code. [More details are available by the basic documentation](https://github.com/microsoft/ApplicationInsights-JS/blob/master/docs/PerformanceMonitoring.md). Since v2.4.0| boolean<br/>Defaults to false
|
|
61
|
-
| perfEvtsSendAll | [Optional] When _enablePerfMgr_ is enabled and the [IPerfManager](https://github.
|
|
51
|
+
| perfEvtsSendAll | [Optional] When _enablePerfMgr_ is enabled and the [IPerfManager](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/IPerfManager.html) fires a [INotificationManager](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/INotificationManager.html).perfEvent() this flag determines whether an event is fired (and sent to all listeners) for all events (true) or only for 'parent' events (false <default>).<br />A parent [IPerfEvent](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/IPerfEvent.html) is an event where no other IPerfEvent is still running at the point of this event being created and it's _parent_ property is not null or undefined. Since v2.4.0 | boolean<br />Defaults to false
|
|
62
52
|
| idLength | [Optional] Identifies the default length used to generate new random session and user id's. Defaults to 22, previous default value was 5 (v2.4.2 or less), if you need to keep the previous maximum length you should set this value to 5. | number<br />Default: 22
|
|
63
53
|
| disableEventTimings | [Optional] Disables additional internal event timings that are added during processing of events, the timings are not sent as part telemetry items to the server. | boolean<br/>Default: false
|
|
64
54
|
| enableCompoundKey | [Optional] Enables support for objects with compound keys which indirectly represent an object where the "key" of the object contains a "." as part of it's name.<br />Example: <code>event: { "somedata.embeddedvalue": 123 } </code> | boolean<br />Default: false
|
|
65
55
|
| disablePageUnloadEvents | [Optional] An array of the page unload events that you would like to be ignored, special note there must be at least one valid unload event hooked, if you list all or the runtime environment only supports a listed "disabled" event it will still be hooked, if required by the SDK.<br /> Unload events include "beforeunload", "unload", "visibilitychange" (with 'hidden' state) and "pagehide"| string[]<br />Default: not specified
|
|
66
56
|
| disablePageShowEvents | [Optional] An array of page show events that you would like to be ignored, special note there must be at lease one valid show event hooked, if you list all or the runtime environment only supports a listed (disabled) event it will STILL be hooked, if required by the SDK.<br/> Page Show events include "pageshow" and "visibilitychange" (with 'visible' state)| string[]<br /> Default: not specified
|
|
67
57
|
|
|
68
|
-
### [IPropertyStorageOverride](https://
|
|
58
|
+
### [IPropertyStorageOverride](https://microsoft.github.io/ApplicationInsights-JS/webSdk/1ds-core-js/interfaces/IPropertyStorageOverride.html)
|
|
69
59
|
|
|
70
60
|
| Config | Description | Type
|
|
71
61
|
|----------------|----------------------------------------|----|
|
|
72
62
|
| setProperty |A function for passing key value pairs to be stored.| function
|
|
73
63
|
| getProperty | A function that gets a value for a given key.| function
|
|
74
64
|
|
|
75
|
-
### [ICookieMgrConfig](https://github.
|
|
65
|
+
### [ICookieMgrConfig](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/ICookieMgrConfig.html)
|
|
76
66
|
|
|
77
67
|
Cookie Configuration for instance based cookie management added in version 3.1.0.
|
|
78
68
|
|
|
@@ -91,16 +81,16 @@ Cookie Configuration for instance based cookie management added in version 3.1.0
|
|
|
91
81
|
|
|
92
82
|
From version 3.1.0, cookie management is now available directly from the instance and can be disabled and re-enabled after initialization.
|
|
93
83
|
|
|
94
|
-
If cookie usage is disabled during initialization via the `disableCookiesUsage` configurations, you can now re-enable via the [ICookieMgr](https://github.
|
|
84
|
+
If cookie usage is disabled during initialization via the `disableCookiesUsage` configurations, you can now re-enable via the [ICookieMgr](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/ICookieMgr.html) `setEnabled` function.
|
|
95
85
|
|
|
96
86
|
The instance based cookie management also replaces the previous CoreUtils and global functions of `disableCookies()`, `setCookie(...)`, `getCookie(...)` and `deleteCookie(...)`. And to benefit from the tree-shaking enhancements also introduced as part of version 3.1.0 you should no longer uses the global functions.
|
|
97
87
|
|
|
98
88
|
### Simplified Usage of new instance Cookie Manager
|
|
99
89
|
|
|
100
|
-
- oneDs.[getCookieMgr()](https://github.
|
|
101
|
-
- oneDs.[getCookieMgr()](https://github.
|
|
102
|
-
- oneDs.[getCookieMgr()](https://github.
|
|
103
|
-
- oneDs.[getCookieMgr()](https://github.
|
|
90
|
+
- oneDs.[getCookieMgr()](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/ICookieMgr.html).setEnabled(true/false)
|
|
91
|
+
- oneDs.[getCookieMgr()](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/ICookieMgr.html).set("MyCookie", "thevalue");
|
|
92
|
+
- oneDs.[getCookieMgr()](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/ICookieMgr.html).get("MyCookie");
|
|
93
|
+
- oneDs.[getCookieMgr()](https://microsoft.github.io/ApplicationInsights-JS/webSdk/applicationinsights-core-js/interfaces/ICookieMgr.html).del("MyCookie");
|
|
104
94
|
|
|
105
95
|
### Blocking individual cookies
|
|
106
96
|
|
|
@@ -121,17 +111,11 @@ var coreConfig: IExtendedConfiguration = {
|
|
|
121
111
|
|
|
122
112
|
## API documentation
|
|
123
113
|
|
|
124
|
-
[
|
|
125
|
-
|
|
126
|
-
## Sample App
|
|
127
|
-
|
|
128
|
-
[React sample App](https://msasg.visualstudio.com/Shared%20Data/_git/1DS.JavaScript.SampleApps.React?path=%2FREADME.md&version=GBmaster&_a=preview).
|
|
129
|
-
|
|
130
|
-
[React Native sample App](https://msasg.visualstudio.com/Shared%20Data/_git/1DS.JavaScript.SampleApps.ReactNative?path=%2FREADME.md&version=GBmaster&_a=preview).
|
|
114
|
+
[Typedoc generated API reference](https://microsoft.github.io/ApplicationInsights-JS/webSdk/1ds-core-js)
|
|
131
115
|
|
|
132
116
|
## Learn More
|
|
133
117
|
|
|
134
|
-
You can learn more in [1DS First party getting started](https://
|
|
118
|
+
You can learn more in [1DS First party (Internal) getting started](https://aka.ms/1dsjs).
|
|
135
119
|
|
|
136
120
|
## Data Collection
|
|
137
121
|
|