A comprehensive guide to all breaking changes for the ArcGIS Maps SDK for JavaScript, ordered by release version. This guide is helpful for people upgrading versions of the API in their app(s). Scroll down to find the current version of the API in use, then follow the changes up to the latest version, and make the relevant updates.
To see all the latest features and advancements, please refer to the Release Notes. To see all the added features and advancements from all versions, please refer to the Previous Versions Release Notes section.
4.33 Core API breaking changesesriConfig.assetsPath = "https://mywebsite.com/assets";
This breaking change includes the projectOperator, shapePreservingProjectOperator, geographicTransformationUtils as well as the geodetic and geodesic operators, and the legacy projection module.polygonOverlayOperator
now returns a result object that includes the polygon array result as well as the corresponding ids
that represent the indexes of the polygons in the input array.{ acceptedFormats: ["web"] }
 as options to fetchSymbol to retrieve only 3D symbols.layer
property of the cloned graphic. This is because the cloned graphic is not associated with any layer. If you need to clone a graphic and associate it with a specific layer, set the layer
property manually after cloning. This affects any workflows that result in cloned graphics, such as search result graphics.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
Map components breaking changesseries
level to inside of a temporalBinning
property.rotation
property is moved from the series
level to the chart
level.null
and undefined
where appropriate. This enhances type safety and makes them compatible with projects where strict
or strictNullChecks
are enabled.open
property was removed from the UtilityNetworkAssociationType. This property is no longer needed to display associations in popups.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
Map components breaking changesbasemap
or item-id
attribute to set the basemap on the component, or set the Map
in JavaScript. Setting basemap="none"
is no longer valid; to create a map without a basemap simply avoid setting the basemap
attribute. Note that if you don't assign a basemap, the arcgisViewReadyChange
event will not fire until the map's properties are updated.drag-label
attribute was removed. Use label
instead.arcgis-sketch.update
was removed. Use arcgis-sketch.triggerUpdate
instead."top-left"
to align with the default position of Zoom and Compass components.arcgis-chart
component.
arcgis-charts-bar-chart
to arcgis-chart
.ArcgisChartsBarChart
to ArcgisChart
.HTMLArcgisChartsBarChartElement
to HTMLArcgisChartElement
.config
property is now model
.arcgisDataProcessComplete
, arcgisLegendItemVisibilityChange
, arcgisSeriesColorChange
, arcgisSelectionComplete
and arcgisAxesMinMaxChange
.actionBarHideActionsProps
to hiddenActions
for the arcgis-charts-action-bar
component.
ActionBarHideActionsProps
is now DefaultChartActions[]
.WebChartProbabilityPlotSeries
, WebChartProfileGraphSeries
, and WebChartProbabilityPlotKinds
.orderByFields
from WebChartSeriesQuery
, use orderOptions
instead.setCategory()
to setXAxisField()
when setting X
properties in the bar chart model.Charts components are still in beta, so the API and user experience may change based on user feedback or an improved design. The following properties were updated/removed in this release:
binTemporalData
property to true
by default for Bar chart date axes; previously, it was set to false
.arcgisChartsDataProcessError
is now arcgisDataProcessError
).showDuplicatedLabelsOnContinuousAxis
. This feature is no longer supported.getColorType()
, setColorType()
. Use getColorMatch()
and setColorMatch()
instead.rotated
, series' colorType
, Pie series' sortLabelsBy
, axis' scrollbarVisible
. rotated
now is available at the chart level, colorMatch
can be used instead of colorType
, sortLabelsBy
is now orderOptions
and axis.scrollbarVisible
is now axis.scrollbar.visible
.stackedType
property to a different level within the chart specification.none
mode to hide
in the WebChartLabelBehavior
specification; the behavior remains the same.@arcgis/map-components-angular
, is no longer available with version 4.31. Use ESM imports to individually load components instead. See the Angular sample on the jsapi-resources GitHub repository.arcgis-js-api
. Use components or the @arcgis/core ES modules package, instead. See the Get started with npm guide topic for more information.@arcgis/cli
has been retired. Use components or the @arcgis/core ES modules package and Calcite, instead. See the Get started with npm guide topic for more information.esri-loader
library has been retired. Use components or the @arcgis/core ES modules package, instead. See the Get started with npm guide topic for more information.decimal-degrees
value from property SizeVariable.valueUnit and AuthoringInfo.lengthUnit.layoutTemplateInfo
and layoutTemplateNorthArrowInfo
from PrintViewModel, use getLayoutTemplateById instead.line
property in Association to geometry
."world-elevation"
value from the arcgis-scene
component's ground
property. Users can still set the property or attribute. The default value was removed to more closely mimic the behavior of the core API's SceneView.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.30 Components breaking changesFor an improved developer experience (e.g., readability and code writing), Map and Coding components have been updated to use a new event naming pattern, arcgis<nameOfEvent>
, instead of arcgis<nameOfComponent><nameofEvent>
. For example, the Bookmarks ready event name was changed from arcgisBookmarksReady
to arcgisReady
. This change does not affect view based components such as arcgis-map
and arcgis-scene
.
Navigational components, such as Zoom, no longer display by default in the arcgis-map
and arcgis-scene
components. The only default component in a map or scene will be the attribution. All other components need to be added manually like so:
Use dark colors for code blocks Copy
1
2
3
4
<arcgis-map basemap="dark-gray-vector" center="-90,38" zoom="5">
<arcgis-zoom position="top-left"></arcgis-zoom>
<arcgis-home position="top-right"></arcgis-home>
</arcgis-map>
Additional breaking changes
For local builds using TypeScript, we are in the process of making the SDK's TypeScript definitions strict null compatible. To complete that process, null/undefined types have been temporarily removed at version 4.30. A potential workaround for specific SDK errors is use a //@ts-expect-error strictNullChecks
comment on the preceding line.
Earlier versions of the API will not honor the timeExtent of Bookmarks authored at version 4.30 or later due to a WebMap serialization error.
FeatureEffect.toJSON() now returns the includedEffect
and excludedEffect
as an array of objects with type
and amount
properties. Previously these were string values.
If you are creating custom classes extending Accessor, following our guide, you need to may need update your class's constructor to pass the arguments to the super constructor:
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
@property("MyClass")
class MyClass extends Accessor {
constructor(properties: Pick<MyClass, "myString">) {
// This previously worked
// super();
// now
super(properties);
}
@property()
myString: string;
}
const instance = new MyClass({ myString: "test" });
console.log(instance.myString);
For local builds, compatibility with Webpack versions prior to 5.84.0
has been removed since 4.29. Upgrade to 5.84.0 or greater.
The DatePicker
and TimePicker
have been removed. Use the Input Date Picker and Input Time Picker Calcite components instead.
The DirectionPoint.endTimeOffset
property was renamed to DirectionPoint.arrivalTimeOffset.
There is no support for printing with any Printing Service published with ArcMap. Instead, publish new Print Services with ArcGIS Pro.
VersionManagementViewModel changed return types for alterVersion
, changeVersion
, deleteVersion
, createVersion
.
With the necessary changes needed to move to a more flexible menu system in FeatureTable, the read-only menu
property has been removed. Instead, access the menu via FeatureTable.menuConfig which references TableMenuConfig.
returnServiceEditsInSourceSR
has been removed as a parameter from the FeatureService.applyEdits method.
The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.29At version 4.29, only WebGL2-enabled browsers are supported for both 2D and 3D. See the System Requirements for more information.
For local builds, using Webpack versions prior to 5.84.0 is not recommended at 4.29. This is related to bug fixes in Webpack.
The hitTest() method on the MapView no longer includes layerId
and layerIndex
in the attributes of a returned graphic for VectorTileLayer. To obtain this information, use the graphic's origin property instead. See the VectorTileLayer hitTest section for more info.
The layer property of a graphic returned in the hit test result for VectorTileLayer is now null
. Use the origin.layer property to access which VectorTileLayer the graphic originates from.
The @arcgis/common-components
(beta) package was removed, which included the arcgis-api-key
and arcgis-identity
components.
At version 4.29, ListItemPanels do not include any padding.
FeatureLayer can no longer be labelled with labelExpression, which is documented as only working with MapImageLayer. Use labelExpressionInfo instead.
The WFSLayer now uses pagination when fetching features from the service, meaning that multiple requests will be sent to retrieve features instead of just one. To match the previous behavior, set maxPageCount: 1
and increase the value of maxRecordCount
.
The Editor's view model no longer creates a single instance of FeatureFormViewModel and SketchViewModel. Prior to this release, if given an instance of EditorViewModel, its featureFormViewModel
and sketchViewModel
properties always referred to the same single instance of their respective view model class for the entirety of the EditorViewModel
lifetime. This meant that certain operations using these view models, could run once and remain effective for all subsequent editing workflows, (e.g. setting properties or installing event listeners on them). Beginning with version 4.29, new instances of FeatureFormViewModel and SketchViewModel are used for each editing workflow. When there isn't an active edit workflow, the FeatureFormViewModel and SketchViewModel properties are null
. When an editing workflow begins, these properties will have values, but any changes or event handlers made to them are only applicable for the duration of that workflow.
The MeshGeoreferencedRelativeVertexSpace
has been removed. Use MeshGeoreferencedVertexSpace with an origin instead. If no origin is specified, the georeferenced vertex space will be considered absolute.
Meshes created via create functions, such as createSphere, are now always created with a relative vertex space where mesh coordinates will be offsets to the location at which the mesh is created. Before, mesh coordinates would always be absolute. If the vertex space type is not provided as an option to the create function, then the vertex space is chosen based on the spatial reference. If it is geographic or WebMercator, MeshLocalVertexSpace is used and MeshGeoreferencedVertexSpace otherwise.
Mesh centerAt will now center meshes with respect to the origin of the vertex space of the mesh. Before, creating a sphere using createSphere at a location, followed by a call to centerAt with the same location as an argument, would move the sphere such that the sphere center aligns with the location. Now calling centerAt with the same location at which the mesh was created will not have any effect. Use offset or adjust the centerAt location by mesh.extent.height/2
.
The FetchPopupFeaturesResult
type definition in the Popup class had the following properties removed from the API at this release:
The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.28 Removal of watchUtilsThe watchUtils
class has been deprecated since version 4.24 and has been removed from the API at this release. This is a breaking change and applications will need to use reactiveUtils
instead, which provides significantly improved utilities and convenience functions for watching properties inherited from Accessor. Check out the Why you should be using reactiveUtils instead of watchUtils blog for more details on how to migrate from watchUtils
to reactiveUtils
.
The @types/arcgis-js-api
package was deprecated in NPM at 4.28. This package was used in AMD-based applications. The definition files are available from the jsapi-resources archive, or NPM install arcgis-js-api
. These changes do not affect applications using ES modules with @arcgis/core
.
IPromise
TypeScript definition was removed at 4.28. Use native Promise
instead.
All instances of *Constructor
TypeScript definitions were removed at 4.28. Update usage of __esri.ModuleConstructor
to typeof __esri.Module
, or import
the module from typings and change the type assignment to typeof Module
, for example:
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
// Type definitions at 4.27 and earlier
type IEsriDeps = [
__esri.MapConstructor,
__esri.MapViewConstructor
];
// Type definitions at 4.28 and later
type IEsriDeps = [
typeof __esri.Map,
typeof __esri.MapView
];
false
.national-geographic
named basemap was removed at 4.28. Four of the other legacy basemaps have been redefined to their vector equivalents because they were based on outdated services that are in Mature Support: topo
, streets
, gray
and dark-gray
.auto
and authorization-code
values for OAuthInfo.flowType no longer check if the popup
property is set to true
or false
. This change affects applications that use the auto
flowType and set the popup
property to true
. The callback page being used needs to be updated to support two-factor authentication. To aid in this, the default oauth-callback.html has been updated to allow for the two-step approach and will still work if using the one-step flow.date
fields is now short-date-short-time
rather than long-month-day-year
in the Popup, Features, or Feature widgets. For example, a date that may have previously appeared as December 30, 1997
will now appear as 12/30/1997 6:00 PM
.true
to false
.pickClosestTarget
in the GoToOptions2D or the ToScreenOptions2D to false
to disable this behavior.maxInlineActions
property on the Popup widget has been removed due to the widget being refactored to utilize Calcite components.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.27View.popupEnabled
is set to true
(which is the default), when View.openPopup()
is called, or when some widgets need the popup, such as Search. In most cases, applications will not need to be updated and will continue to work. However, if attempting to access the view.popup
property before it is instantiated, some issues may occur. See Loading the Popup for details on how to update your apps to take advantage of these performance improvements. Alternatively, you can simply create a new instance of the Popup when instantiating the View, as shown in the code snippet below. Note: this will not take advantage of the deferred loading.
Use dark colors for code blocks Copy
1
2
3
4
5
// Create a new MapView
const view = new MapView({
// set the popup property to a new instance of Popup
popup: new Popup(...)
});
The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.26updateEnabled
to false
will not disable the ability to delete
features. Prior to this release, setting updateEnabled
to false
would prevent both updates and deletes on a feature. Now if deletes are needed, it is necessary to also set deleteEnabled
to true
.true
to false
.globalIdsFilter
property of GraphSearchStreaming was replaced with idsFilter
.defaultTravelMode
property of type TravelMode instead of type string.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
Class/Property/Method/Event Alternate option Version deprecatedesri/widgets/Slice/SlicePlane
esri/analysis/SlicePlane 4.23 Knowledge Graph beta changes
The knowledgeGraphService remains in beta. Capabilities in version 4.26 are only supported against ArcGIS Enterprise 11.1 and later. To access a knowledgeGraphService on ArcGIS Enterprise 11.0 and earlier, use version 4.25.
In 4.26/Enterprise 11.1, the data model and service definition of knowledge graph services were updated. With the exception of GraphSearchStreaming.globalIdsFilter
, this change will not break client-side code written using the methods for knowledgeGraphService. The table below lists the knowledge graph properties that have been removed at this release:
outStatistic
property. Aggregate fields are now defined using onStatisticField
, and onStatisticExpression
.show
to hide-children
.URL
string to the sprite source.Point[]
to type FeatureSet.Polygon[]
to type FeatureSet.Polyline[]
to type FeatureSet.Graphic[]
to type FeatureSet.multi-directional
to traditional
.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.24esri/rest
folder. This will make it easier to incorporate your code into a more modular app design, and also reduce unnecessary dependencies (you only import what you want). The new rest modules are functions, which do not require constructors, so you can use their methods immediately. See the full list of removed task modules in the Complete list of removed tasks
dropdown below.date
and displayUTCOffset
have been removed from the VirtualLighting since this lighting type does not depend on the date and time. But this means that the view.environment.lighting
property does not always have a date
or displayUTCOffset
property. For some applications that assume that this property always exists this can be a breaking change.hitTest()
method should be updated to check for the result type.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
The following tasks have been deprecated for at least 3 releases and have now been removed from the API:
4.23AnimatedFlowRenderer
, which was released in beta at version 4.22, was renamed as FlowRenderer in this release.middle
to baseline
. To revert to the alignment behavior of previous releases, set the verticalAlignment
of the text symbol to middle
.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.22.tsx
Widget view source code files for all out-of-the-box widgets. This change does not affect the ability to build custom widgets, extend the ViewModel or customize widget CSS.list
as the default displayType. Instead of list
, it defaults to auto
.justify
as a possible value for TextSymbol.horizontalAlignment.basemap
parameter in all smartMapping methods within the esri/smartMapping/renderers
folder was deprecated at version 4.13 and is now replaced by the view
parameter.requestDelay
property was removed from the CoordinateConversion widget and CoordinateConversionViewModel.json
or text
. This means after interceptors that were expecting array-buffers
for client-side layers such as GeoJSONLayer and CSVLayer will now receive the expected data types json
or text
.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.21onBlur
. Moving forward, this has been updated to use onInput
with values getting validated as a user types. Date values will only be applied onInput
if the value is valid. It will subsequently be committed or discarded onBlur
based on the final value.The following classes, methods, properties and events have been deprecated for at least 2 releases and have been removed from the API:
4.20codedValue
have not changed.RotateEventInfo.angle
is now reported in degree by the SketchViewModel.Ctrl
to Shift
in Sketch and SketchViewModel for creating a polgyon
graphic (rectangle
or circle
) with predefined shapes.C
to Enter
in Sketch, SketchViewModel, and Draw for completing a polyline
, polygon
, or point
graphic.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.19setRedirectionHandler
method and useSignInPage
property were removed at 4.19. This was a result of Enterprise Portal apps no longer making use of this functionality beginning with the upcoming Enterprise 10.9.1 release.false
. Prior to version 4.19, this was not necessary. All that was needed to remove a default action, e.g. the "Zoom to" button, was to directly set the popup's actions. This would disable the "Zoom to" button from displaying.Input
and TextInput
have been removed in favor of exposing only their subclass types. These subclass types include TextAreaInput, TextBoxInput, and DateTimePickerInput. In addition to the latter three types, some additional new input types were also included at 4.19. These include BarcodeScannerInput, RadioButtonsInput, and ComboBoxInput. No properties or functionality was removed with Input
and TextInput
. These two classes' properties are now accessible directly from their subclasses.esri/layers/support/AttachmentInfo
has been moved to esri/rest/query/support/AttachmentInfo. While the older class will still work with JavaScript, you will need to update the reference to the new class location to get the correct typings with TypeScript.@renderable
decorator has been deprecated and removed in the esri widgets helper class. Nothing else is required by the developer as widgets should still work as expected.dependsOn
with the @property
decorator when defining an Accessor property.requestOptions
property from the following tasks (requestOptions
is still available as an optional method parameter): ClosestFacilityTask, FindTask, GeometryService, IdentifyTask, ImageIdentifyTask, ImageServiceIdentifyTask, PrintTask, RouteTask, ServiceAreaTask.The following classes, methods, properties and events have been deprecated for at least 2 releases and have now been removed from the API:
4.18takeScreenshot()
method on MapView and SceneView has changed to png
instead of jpg
.mediaType
property was removed from OGCFeatureLayer. All requests for metadata and data content will be made with the "f=json"
url parameter.null
if there was no feature provided.undefined
if there is no existing attribute on the edit feature. This is meant to distinguish from valid null
values.50
records unless the layer contains less than this. If so, it will take this count and set the pagination to it.Function
.click
instead of hybrid
.RouteParameters.barriers
property has been removed. It was deprecated as of version 4.11. Use pointBarriers, polygonBarriers, and/or polylineBarriers instead.view.destroy()
now destroys all attached resources, including the map. To prevent the map from being destroyed, you can unset the map before calling destroy()
.Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
// destroy the view and all attached resources
view.destroy();
// unset map from the view so that it is not destroyed
// then destroy the view and all attached resources
const map = view.map;
view.map = null;
view.destroy();
types
as either button
or toggle
. Prior to this, it was set as string
.goToMedia()
method in the Feature widget and its corresponding viewModel has been renamed to setActiveMedia.tables
property for WebMap now takes a collection of Layers instead of an array of Objects.TimeSlider.loop
property now has a default value of false
instead of true
.FeatureServer/layers/REST
endpoint as opposed to each layer fetching its metadata from its dedicated endpoint, e.g. (FeatureServer/<layerID>)
.StreamLayer.maximumTrackPoints
was deprecated at version 4.15 and is now removed. Use StreamLayer.purgeOptions.maxObservations instead.hasZ: false
no longer silently drops the z-value and now throws an error.outFields
on the FeatureLayer or the PopupTemplate. It was always recommended to set this, but was never required. Going forward, if needing access to the underlying feature's geometry, this property must be set. This also holds true if working with WebMaps containing popups. If a popup does not have a referenced Arcade expression that works with geometry, it is now required to access either the WebMap's layer or its PopupTemplate and set the outFields
.has
flag "esri-native-promise"
is no longer supported.declare
module. This means that apps with classes that leverage the API class framework and multiple inheritance will stop working. The recommended approach is to use mixins with Accessor.TileImageryLayer
is removed and replaced by the ImageryTileLayer.undefined
values for start and end properties if the two time extents do not intersect.false
when the view container's css style visibility
is set to hidden
(visibility:hidden
). The view is hidden but it renders and updates data now.cimSymbol.data.symbol
.Promise
by default as of 4.15. See API Modernization for more information.dgrid
styles are no longer globally included. If using dgrid
in your web application, you will need to reference the stylesheet separately.ImageMeshColor
, which was deprecated since version 4.11. Set MeshTexture on MeshMaterial.colorTexture instead.requireUtils
, which was deprecated since version 4.10. Use promiseUtils.create() instead.ValueMeshColor
, which was deprecated since version 4.11. Use MeshMaterial.color instead.capabilities
and version
properties from StreamLayer.update
event on Sketch widget and SketchViewModel no longer have cancel
state. The parameter aborted
on update
events indicates that the process got cancelled.attachmentInfos
property has been removed from AttachmentsContent. It is now handled via the Attachments widget and can be accessed via its viewModel.activeWorkflow
property now returns either a reference to either a CreateWorkflow or UpdateWorkflow.stopPropagation()
is called on an immediate-click event, click and double-click events are no longer emitted. When stopPropagation()
is called on an pointer-up event, immediate-click, click and double-click are no longer emitted. This makes implementing event handlers easier, since applications usually want to handle only one of those event types at a time.z-values
in 2D MapView even if the query.returnZ is set to true
.continuous
. This allows you to continuously create graphics with same geometry types by default. This is different from the widget's default behavior in previous releases, where you could create a single graphic at a time.Shift + Left-click
combination instead of Ctrl + Left-click
on vertices.esri-area-measurement-3d
to esri-area-measurement-2d
and from esri-direct-line-measurement-3d
to esri-distance-measurement-2d
.getImageUrl()
method from MapImageLayer. This method was deprecated since version 4.11. We recommend extending BaseDynamicLayer instead.value-change
and values-change
events from Slider and HistogramRangeSlider. These events were deprecated since version 4.13. We recommend watching the values property or using the other widget events instead.StretchRenderer
is removed and replaced by the RasterStretchRenderer.updateDelay
property.cancelJobStatusUpdates()
method.MapImageLayer
was returned.GPFeatureRecordSetLayer
or GPRecordSet
it returns a DataFile when a url
property is detected.mode
property from the AreaMeasurement2D
and DistanceMeasurement2D
widgets and ViewModels. See Measurement Enhancements for more information.pixelSizeX
and pixelSizeY
properties from ImageServiceIdentifyParameters. Use pixelSize property instead.domainFields
property ImageryLayer. Use fields property instead.hasRasterAttributeTable
and rasterAttributeTable
properties from ImageryLayer. Use the ImageryLayer's serviceRasterInfo.attributeTable property instead.reset
method from Sketch and SketchViewModel. Use cancel method on respective classes.value-change
event from SliderViewModel.0
to each bar element.filter
and updateFilter
from StreamLayer.connect
, disconnect
, graphics
, and updateFilter
from StreamLayerView.(location, distance, requestOptions)
to now accept (params, requestOptions)
. The params
object has two properties: location and locationType
.SceneLayer.outFields
in advance.null
it will display transparent.webdoc.applicationProperties
module, common for WebMap and WebScene.actionsMenuEnabled
property from Popup.dotBlendingEnabled
and referenceDotValue
properties from DotDensityRenderer.distance
parameter from esri/widgets/Search and esri/tasks/Locator as it is deprecated and no longer recognized by the World Geocoding Service.localSearchOptions
and locationToAddressDistance
properties from esri/widgets/Search. These properties were deprecated at version 4.11.material
property from the base class Symbol3DLayer. With this new behavior, subclasses of Symbol3DLayer implement the material
property independently.noData
property from ImageServiceIdentifyParameters.timeExtent
property from TimeInfo. Use fullTimeExtent property instead.esri/widgets/ColorSizeSlider
with esri/widgets/smartMapping/ColorSizeSlider.esri/widgets/ColorSlider
with esri/widgets/smartMapping/ColorSlider.esri/widgets/SizeSlider
with esri/widgets/smartMapping/SizeSlider.content
and/or title
can no longer be set using a wildcard, e.g. *
. Instead, set the Popup's
defaultPopupTemplateEnabled property to true.DateString
, DateFormat
, and NumberFormat
formatter functions are no longer supported when used with a PopupTemplate's content
and/or title
. Instead, set it via the FieldInfo's fieldInfoFormat.noDataValue
parameter is now nested within the options
parameter when using ElevationLayer.fetchTile() method.esri/core/lang.substitute()
, dojo/number.format()
, and dojo/date.format()
methods.content
and/or title
are no longer supported.height
, nor width
are set for PathSymbol3DLayer then the symbol doesn't render. This is a breaking change from previous versions when not setting size
used to renderer the symbol with a height and a width of 1 meter.null
unless it is explicitly set.
null
instead of meters
.0.1
would be interpreted as fully transparent (i.e. masking), now this threshold was moved to 0.5
. If the old behavior is desired, the threshold can now be explicitly changed using the alphaCutoff property.select
method out of FeatureTemplates and into the FeatureTemplatesViewModel.contentEnabled
property on both the Feature widget and the FeatureViewModel.esri/geometry/ScreenPoint
class.Legend
support from MapNotesLayer.token
property from all layer classes. The recommended approach to pass a token on a layer is to use IdentityManager.registerToken() or to use esriConfig.request.interceptors.view
property from Feature widget and FeatureViewModel.null
.definitionExpression
property of AttachmentQuery class to where.definitionExpression
property of RelationshipQuery class to where.TemplateItemGroup.name
to TemplateItemGroup.label.FeatureLayerSearchSource
class to LayerSearchSource.
FeatureLayer
.sources
property within the Directions.SearchProperties object now takes a LayerSearchSource as opposed to FeatureLayerSearchSource
.esri/views/2d/draw/Draw
to esri/views/draw/Draw.esri/views/2d/draw/DrawAction
to esri/views/draw/DrawAction.esri/views/2d/draw/PointDrawAction
to esri/views/draw/PointDrawAction.esri/views/2d/draw/PolylineDrawAction
to esri/views/draw/PolylineDrawAction.esri/views/2d/draw/PolygonDrawAction
to esri/views/draw/PolygonDrawAction.esri/views/2d/draw/MultipointDrawAction
to esri/views/draw/MultipointDrawAction.esri/views/2d/draw/SegmentDrawAction
to esri/views/draw/SegmentDrawAction.Chart
class from esri/support/ContentElement/Media/Chart
.Media
class from esri/support/ContentElement/Media/Media
.esri/support/ExpressionInfo
to esri/popup/ExpressionInfo
.esri/support/FieldInfo
to esri/popup/FieldInfo
.esri/support/LayerOptions
to esri/popup/LayerOptions
.esri/support/RelatedRecordsInfo
to esri/popup/RelatedRecordsInfo
.ContentElement
class from esri/support/ContentElement
to content and moved to esri/popup/content
.ContentElement
class from esri/support/ContentElement/ContentElement
to Content and moved to esri/popup/content/Content
.Attachments
class from esri/support/ContentElement/Attachments
to AttachmentsContent and moved to esri/popup/content/AttachmentsContent
.Fields
class from esri/support/ContentElement/FieldsContent
to FieldsContent and moved to esri/popup/content/FieldsContent
.Text
class from esri/support/ContentElement/Text
to TextContent and moved to esri/popup/content/TextContent
.Media
class from esri/support/ContentElement/Media
to MediaContent and moved to esri/popup/content/MediaContent
.BarChart
class from esri/support/ContentElement/Media/BarChart
to BarChartMediaInfo and moved to esri/popup/content/BarChartMediaInfo
.FieldsOrder
class from esri/support/RelatedRecordsInfo/FieldOrder
to RelatedRecordsInfoFieldOrder and moved to esri/popup/support/RelatedRecordsInfoFieldOrder
.Format
class from esri/support/FieldInfo/Format
to FieldInfoFormat and moved to esri/popup/support/FieldInfoFormat
.Series
class from esri/support/ContentElement/Media/Chart/Series
to ChartMediaInfoValueSeries and moved to esri/popup/content/support/ChartMediaInfoValueSeries
.Value
class from esri/support/ContentElement/Media/Chart/Value
to ChartMediaInfoValue and moved to esri/popup/content/support/ChartMediaInfoValue
.ColumnChart
class from esri/support/ContentElement/Media/ColumnChart
to ColumnChartMediaInfo and moved to esri/popup/content/ColumnChartMediaInfo
.LineChart
class from esri/support/ContentElement/Media/LineChart
to LineChartMediaInfo and moved to esri/popup/content/LineChartMediaInfo
.PieChart
class from esri/support/ContentElement/Media/PieChart
to PieChartMediaInfo and moved to esri/popup/content/PieChartMediaInfo
.Image
class from esri/support/ContentElement/Media/Image
to ImageMediaInfo and moved to esri/popup/content/ImageMediaInfo
.Value
class from esri/support/ContentElement/Media/Image/Value
to ImageMediaInfoValue and moved to esri/popup/content/support/ImageMediaInfoValue
.CalciteWebCoreIcons
to calcite-web-icons
for 2D MapViews.type
property to be set for each field.FieldOptions
class has been removed and merged with the FieldConfig class.event.stopPropagation()
to allow manual display of a Popup with the view's click event. Set the new autoOpenEnabled to false
instead.IdentityManagerBase
has been merged into IdentityManager.esri/widgets/Bookmarks/Bookmark
to esri/webmap/Bookmark
.FeatureLayer.queryFeatureAttachments()
method is removed. Use FeatureLayer.queryAttachments instead.corsDetection
, corsDetectionTimeout
, corsEnabledServers
, forceProxy
, and useCors
properties.allowImageDataAccess
requestOption property from the esriRequest method. Also removed it as a property from MapImageLayer, BingMapsLayer, and OpenStreetMap options. The API automatically allows this without having to explicitly set it.isMaxInclusive
property from ClassBreaksRenderer.popupOpenOnSelect
property from Search widget and SearchViewModel.trustedServers
property available in esriConfig's request property if needing to include credentials such as cookies and authorization headers in cross origin requests. Prior to version 4.9, this would be handled by setting corsEnabledServers withCredentials
property to true
.esri-widget__header
, was renamed to .esri-widget__heading
. For additional information on working with this style, see the Styling guide topic.animate
option is set to false
.minSize
property from pointSizeAlgorithm.draw-start
event was renamed to create-init, draw-cancel
to create-cancel and draw-complete
create-complete and update-start
was renamed to update-init.always()
and otherwise()
methods were deprecated at 4.7 and have been removed as of version 4.8.defaultSource
from both the Search widget and SearchViewModel. Instead, use the defaultSources property.state
property was removed from the Search widget and added into the SearchViewModel..esri-widget-button
, has been renamed to .esri-widget--button
(take note of the two dashes --
before button
).Action
class has been deprecated. You should now use either ActionButton or ActionToggle in its place.popupTemplate
from the graphic's layer.layers
property to layer
in AttributionItem.classificationMethod
property from ClassBreaksRenderer.createActionsFunction
property from LayerList and LayerListViewModel (use listItemCreatedFunction
instead).graphic
property from draw-complete.styleOrigin
property from LabelSymbol3D.then()
method from all classes (use when() instead when using Promises).attributionText
and itemDelimiter
have moved from AttributionViewModel to the Attribution widget.searching
property has been replaced with state.relationParam
property on Query is renamed to relationParameter.relationParam
property on RelationParameters is renamed to relationParameter.String
only now. When initializing a VectorTileLayer with style JSON object, use VectorTileLayer's style property instead.type
property in all renderer, symbol, and symbol layer classes is no longer read-only.type
value for many renderers for consistent kebab-casing:
uniqueValue
to unique-value
.classBreaks
to class-breaks
.pointCloudClassBreaksRenderer
to point-cloud-class-breaks
.pointCloudRGBRenderer
to point-cloud-rgb
.pointCloudStretchRenderer
to point-cloud-stretch
.pointCloudUniqueValueRenderer
to point-cloud-unique-value
.simple-marker-symbol
to simple-marker
.simple-line-symbol
to simple-line
.simple-fill-symbol
to simple-fill
.picture-marker-symbol
to picture-marker
.picture-fill-symbol
to picture-fill
.text-symbol
to text
.point-symbol-3d
to point-3d
.line-symbol-3d
to line-3d
.polygon-symbol-3d
to polygon-3d
.mesh-symbol-3d
to mesh-3d
.label-symbol-3d
to label-3d
.web-style-symbol
to web-style
.zoomScale
property in Search sources now automatically uses the set scale. Prior to this version, it would only zoom to the scale if the search result did not have an associated extent.cancelSuggest
from SearchViewModel.getEffectivePopupTemplate
method. Instead, if the graphic's popupTemplate is not defined, it will use the graphic's layer popupTemplate
.minScale
and maxScale
properties from ElevationLayer.address
and attributes
. Note that there are no changes to the other AddressCandidate properties: extent
, location
and score
.
locationToAddress()
incorrectly returned an object that always had an empty attributes
property, and the address
string was an object. As of 4.4, the address
property is a string, and the attributes
property will be populated.CountryCode
, should now be written as attributes.CountryCode
. (Prior to this version, it was written as address.CountryCode
.)0
on a ObjectSymbol3DLayer will make the symbol point North and setting it to 180
will make the symbol point South. In comparison to the old styles, Signs and signals and Street scene changed orientation by 180 degrees and Transportation changed by 90 degrees.token
property, or 2) appending it to the end of the layer URL.filter
option which replaces the now deprecated searchQueryParams
, suggestQueryParams
, and searchExtent
property."jsxFactory": "tsx",
instead of "reactNamespace": "jsxFactory",
. This is discussed in the TypeScript setup guide topic.stopPropagation()
on the click event object.sizeRendererCreator.createVisualVariable()
was renamed to sizeRendererCreator.createVisualVariables() because it now returns an array of visual variables.ACCESS_TOKEN
layer-add
, layer-remove
, and layer-reorder
events were removed from GroupLayer, Map and its subclasses. Use the change event of esri/core/Collection
instead.This was the first official release of the 4x API. Since the prior 4x releases were in beta
, they will not be considered here.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4