Should I use it? This setting should only be used for migrating legacy codebases that depend on this behavior and is otherwise not recommended.

Other new features

<dom-repeat>

• reuseChunkedInstances

  What does it do? This boolean property causes <dom-repeat> to reuse template instances even when items is replaced with a new array, matching the Polymer 1 behavior.

  By default, a <dom-repeat> with chunking enabled (i.e. initialCount >= 0) will drop all previously rendered template instances and create new ones whenever the items array is replaced. With reuseChunkedInstances set, any previously rendered template instances will instead be repopulated with data from the new array before new instances are created.

  Should I use it? This flag is generally recommended and can improve rendering performance of chunked <dom-repeat> instances with live data.

LegacyElementMixin

• disable-upgrade

  What does it do? LegacyElementMixin now has built-in support for the disable-upgrade attribute (usually provided by DisableUpgradeMixin) that becomes active when the global legacyOptimizations setting is enabled, matching the Polymer 1 behavior.

  Should I use it? Consider using this setting if you are already using the legacyOptimizations setting and migrating older components that depend on disable-upgrade without explicit application of DisableUpgradeMixin.

Bug fixes

<dom-repeat>

• Chunking behavior

  <dom-repeat> no longer resets the number of rendered instances to initialCount when modifying items with PolymerElement's array modification methods (splice, push, etc.). The number of rendered instances will only be reset to initialCount if the items array itself is replaced with a new array object.

  See #5631 for more information.

All commits

• [ci skip] bump to 3.4.0 (commit)

• shareBuiltCSSWithAdoptedStyleSheets -> useAdoptedStyleSheetsWithBuiltCSS (commit)

• formatting (commit)

• Fix incorrect JSDoc param name. (commit)

• Gate feature behind shareBuiltCSSWithAdoptedStyleSheets; update tests. (commit)

• Add shareBuiltCSSWithAdoptedStyleSheets global setting (commit)

• Add stalebot config (commit)

• Annotate more return types as !defined (#5642) (commit)

• Ensure any previously enqueued rAF is canceled when re-rendering. Also, use instances length instead of renderedItemCount since it will be undefined on first render. (commit)

• Improve comment. (commit)

• Remove obsolete tests. (commit)

• Simplify by making limit a derived value from existing state. This centralizes the calculation of limit based on changes to other state variables. (commit)

• Update Sauce config to drop Safari 9, add 12 & 13. Safari 9 is now very old, and has micro task ordering bugs issues that make testing flaky. (commit)

• Remove accidental commit of test.only (commit)

• When re-enabling, ensure __limit is at a good starting point and add a test for that. Also: * Ensure __itemsArrayChanged is cleared after every render. * Enqueue __continueChunkingAfterRaf before notifying renderedItemCount for safety (commit)

• Remove accidental commit of suite.only (commit)

• Ensure limit is reset when initialCount is disabled. Note that any falsey value for initialCount (including 0) is interpreted as "chunking disabled". This is consistent with 1.x logic, and follows from the logic of "starting chunking by rendering zero items" doesn't really make sense. (commit)

• Updates from review. * Refactoring __render for readability * Removing __pool; this was never used in v2: since we reset the pool every update and items are only ever pushed at detach time and we only detach at the end of updates (as opposed to v1 which had more sophisticated splicing) (commit)

• Store syncInfo on the dom-if, but null it in teardown. (same as invalidProps for non-fastDomIf) (commit)

• Fixes for several related dom-repeat chunking issues. Fixes #5631. * Only restart chunking (resetting the list to the initialCount) if the items array itself changed (and not splices to the array), to match Polymer 1 behavior. * Add reuseChunkedInstances option to allow reusing instances even when items changes; this is likely the more common optimal case when using immutable data, but making it optional for backward compatibility. * Only measure render time and throttle the chunk size if we rendered a full chunk of new items. Ensures that fast re-renders of existing items don't cause the chunk size to scale up dramatically, subsequently causing too many new items to be created in one chunk. * Increase the limit by the chunk size as part of any render if there are new items to render, rather than only as a result of rendering. * Continue chunking by comparing the filtered item count to the limit (not the unfiltered item count). (commit)

• Update comment. (commit)

• Store syncInfo on instance and don't sync paths. Fixes #5629 (commit)

• Avoid Array.find (doesn't exist in IE) (commit)

• Add comment to skip. (commit)

• Skip test when custom elements polyfill is in use (commit)

• Copy flag to a single location rather than two. (commit)

• Lint fix. (commit)

• Update test name. (commit)

• Introduce opt-out per class for legacyNoObservedAttributes (commit)

• Ensure telemetry system works with legacyNoObservedAttributes setting (commit)

• Update package-lock.json (commit)

• Update test/unit/inheritance.html (commit)

• Fix testing issues with latest webcomponentsjs (commit)

• Allow undefined in legacy _template field to fall-through to normal lookup path. (commit)

• re-add npm cache (commit)

• regen package-lock (commit)

• mispelled services, node 10 for consistency (commit)

• modernize travis (commit)

• Adds support for imperatively created elements to legacyNoObservedAttributes (commit)

• Rebase sanitize dom value getter onto legacy-undefined-noBatch (#5618) (commit)

• Add getSanitizeDOMValue to settings API (#5617) (commit)

• FIx closure annotation (commit)

• Fix closure annotation. (commit)

• legacyNoObservedAttributes: Ensure user created runs before attributesChanged (commit)

• Enable tests for legacyNoObservedAttributes (commit)

• Only auto-use disable-upgrade if legacyOptimizations is set. (commit)

• Adds disable-upgrade functionality directly to LegacyElementMixin (commit)

• Add doc comment (commit)

• Lint fixes. (commit)

• Update externs. (commit)

• Update extern format. (commit)

• Address review feedback. (commit)

• Address review feedback (commit)

• Lint fixes. (commit)

• Adds legacyNoAttributes setting (commit)

• [ci skip] update changelog (commit)

• Update polymer externs for new settings. (commit)

• Update lib/utils/settings.js (commit)

• Changes based on review. (commit)

• Add basic support for adoptedStyleSheets (commit)

• [ci skip] Add/fix comments per review. (commit)

• Add missing externs for global settings. (commit)

• Revert optimization to not wrap change notifications. This was causing a number of rendering tests to fail. Needs investigation, but possibly because wrapping calls ShadyDOM.flush, and this alters distribution timing which some tests may have inadvertently relied on. (commit)

• Reintroduce suppressTemplateNotifications and gate Dom-change & renderedItemCount on that. Matches Polymer 1 setting for better backward compatibility. (commit)

• Add notifyDomChange back to dom-if & dom-repeat to match P1. (commit)

• Simplify host stack, set __dataHost unconditionally, and make _registerHost patchable. (commit)

• Move @private annotation to decorate class definition. (commit)

• Add type for _overrideLegacyUndefined. (commit)

• Attempt to fix travis issues (commit)

• Revert isAttached change based on review feedback. Deemed a breaking change. (commit)

• Update travis to use xenial distro and, latest Firefox, and node 10 (commit)

• Applies micro-optimizations and removes obsolete settings (commit)

• Work around Closure Compiler bug to avoid upcoming type error (commit)

• Only import each file once (#5588) (commit)

• Avoid Array.from on Set. (commit)

• Update nested template names. (commit)

• Add runtime stamping tests around linking & unlinking effects. (commit)

• Ensure parent is linked to child templateInfo. Fixes fastDomIf unstopping issue. (commit)

• Remove unused TemplateInfo properties from types. (commit)

• Add other used TemplateInfo property types. (commit)

• Add type for TemplateInfo#parent. (commit)

• [ci-skip] Add comment explaining confusing check in _addPropertyToAttributeMap (commit)

• Ensure clients are flushed when runtime stamping via _stampTemplate. Maintains flush semantics with Templatizer stamping (relevant to fastDomIf, which is a switch between Templatizer-based stamping and runtime _stampTemplate-based stamping). Works around an issue with noPatch where nested undistributed dom-if's won't stamp. The changes to the tests are to remove testing that the full host tree is correct since the host doing the runtime stamping will no longer be the DOM getRootNode().host at ready time (this is exactly the case with Templatizer, whose semantics we intend to match). (commit)

• Fix template-finding issue with DisableUpgrade mixin. The existing rules are that prototype._template is first priority and dom-module via is is second priority for a given class. A subclass has a new shot at overriding the previous template either by defining a new prototype._template or a new is resulting in a dom-module lookup. However, trivially subclassing a Polymer legacy element breaks these rules, since if there is no own prototype._template on the current class, it will lookup a dom-module using is from up the entire prototype chain. This defeats the rule that a prototype._template on the superclass should have taken priority over its dom-module. This change ensures that we only lookup dom-module if the class has an own is property. (commit)

• Fix issue with camel cased properties and disable-upgrade (commit)

• More closure fixes. (commit)

• closure fixes (commit)

• lint fixes (commit)

• Fix issue with defaults overriding bound values when disable-upgrade is used. (commit)

• Add closure types (commit)

• Use DisbleUpgradeMixin in legacy class generation (commit)

• Add comment about why code is duplicated. (commit)

• Add tests for connected/disconnected while disabled (commit)

• Improve comments. (commit)

• Added comments. (commit)

• Fix typo and improve readbility (commit)

• Enable disable-upgrade when legacyOptimizations is set to true (commit)

• Remove use of Object.create on template info (significant perf impact). (commit)

• Attempt to sync host properties on every call to _showHideChildren. Fixes an issue where a dom-if that is toggled synchronously true-false-true could fail to sync properties invalidated while false, since the hidden state is only checked at render timing, and the newly added dirty-check could fail if the hidden state has been changed back to its initial value. (commit)

• Add tests for extension and dom-if/repeat (commit)

• Update stand alone disable-upgrade mixin. (commit)

• Remove cruft from test (commit)

• Simplify logic for disable-upgrade (commit)

• Use a safer flag, based on internal testing. (commit)

• Reorder based on review feedback. (commit)

• Fix closure type. (commit)

• Updated comment. (commit)

• Ensure hasPaths is also accumulated as part of info necessary to sync. (commit)

• Fix one more closure annotation. (commit)

• Simplify algorithm; we already have list of computed deps in effect list. (commit)

• Build computed graph from dependencies, rather than properties. (commit)

• Fix closure annotations for dom-if. (commit)

• Avoid lint warnings. (commit)

• Minor simplifications/comments. (commit)

• Updates from review. (commit)

• Closure type fixes. (commit)

• Initialize all settings from Polymer object when available. (commit)

• Fix host prop merging. (commit)

• Updates based on review. (commit)

• Fix defaults back to false for new settings. (commit)

• Add a dirty check to showHideChildren (commit)

• Fix host property syncing (commit)

• Adds disable-upgrade directly into legacy Polymer elements (commit)

• Refactor DomIf into separate subclasses. (commit)

• Runtime stamped dom-if (commit)

• dom-if/dom-repeat bind-to-parent (commit)

• Fix a few closure compiler issues (commit)

• [ci skip] Add comment (commit)

• Fix typo in comment (commit)

• Cleanup, add tests. * remove old implementation * add API docs * rename some API * add dynamicFn to dep count * add test for method as dependency (commit)

• [wip] Add additional topo-sort based algorithm. (commit)

• Dedupe against a single turn on only under orderedComputed (commit)

• Fix closure issues (commit)

• Add hasPaths optimziation (commit)

• Minor comment updates (commit)

• Evaluate computed property dependencies first. Fixes #5143 (commit)

• Add more externs (commit)

• Fix lint warnings (commit)

• Add comments per review feedback (commit)

• Add legacyNotifyOrder. Improve comments. (commit)

• Add test for literal-only static function. (commit)

• Remove unnecessary literal check (commit)

• Simplify (commit)

• Add templatizer warnings. Move to legacyWarnings flag. (commit)

• Add legacyUndefined and legacyNoBatch to externs (commit)

• NOOP has to be an array for closure compiler (commit)

• Add comments on warning limitations. (commit)

• Ensure properties are set one-by-one at startup. (commit)

• Remove unnecessary qualification. (commit)

• Avoid over-warning on templatizer props and "static" dynamicFns. (commit)

• Store splices directly on array when legacyUndefined is set (commit)

• Fix test (commit)

• Add arg length check (commit)

• Adds legacyNoBatch setting (commit)

• Add tests for legacyUndefined setting (commit)

• Adds legacyUndefined setting (commit)