Third Party Hell (BestOfWeb)

Transcript

1. third party hell a journey coding in hostile environments
2. Matthias Le Brun @bloodyowl lead front-end developer beop.io co-founder & podcast host putaindecode.io
3. third party?
4. example.first-party first party page
5. example.first-party first party page <script src="service.third-party" >!</script> #// or <iframe src="service.third-party" %/>
7. use case?
8. use case? • widgets • players • analytics
9. why not integrate with the back-ends of our customers?
10. • ∞ impl. • updates • UX et capabilities
11. strategy
12. let's make a widget
14. approach #1 inject our DOM elements directly in the first party page
15. approach #1 Nice what we wrote
16. approach #1 Nice Nice Nice -> Nice Nice what shows up Nice
17. approach #1 CSS™
18. CSS™ • Cascading • Inheritance
19. approach #1 first party CSS resets & defaults will f*ck things in unexpected ways
20. approach #1 inline CSS or ensure your stylesheet is always the last one in the DOM
21. approach #1 • unset all properties • unset all pseudo-elements • unset weird vendors selectors • use highest-pri selectors • !important
22. Alpha() AlphaImageLoader() :active additive-symbols (@counter-style) '::after (:after) align-content align-items align-self all <an-plus-b> <angle> animation animation-delay animation-direction animation-duration animation-fill-mode animation-iteration-count animation-name animation-play-state animation-timing- function @annotation annotation() attr() Barn() BasicImage() BlendTrans() Blinds() Blur() '::backdrop backface-visibility background background-attachment background-blend-mode background-clip background-color background-image background-origin background-position background-repeat background-size <basic- shape> '::before (:before) <blend-mode> block-size blur() border border-block-end border-block-end-color border-block-end-style border-block-end-width border-block-start border-block-start-color border-block-start-style border-block-start-width border-bottom border-bottom-color border-bottom-left-radius border-bottom-right-radius border-bottom-style border-bottom-width border-collapse border-color border-image border-image-outset border-image-repeat border- image-slice border-image-source border-image-width border-inline-end border-inline-end-color border-inline-end-style border-inline-end-width border-inline- start border-inline-start-color border-inline-start-style border-inline-start-width border-left border-left-color border-left-style border-left-width border-radius border-right border-right-color border-right-style border-right-width border-spacing border-style border-top border-top-color border-top-left- radius border-top-right-radius border-top-style border-top-width border-width bottom @bottom-center box-decoration-break box-shadow box-sizing break-after break-before break-inside brightness() CheckerBoard() Chroma() Compositor() calc() caption-side caret-color ch @character-variant character-variant() @charset :checked circle() clear clip clip-path cm <color> color column-count column-fill column-gap column-rule column-rule-color column-rule-style column- rule-width column-span column-width columns content contrast() <counter> counter-increment counter-reset @counter-style cross-fade() cubic-bezier() '::cue cursor <custom-ident> DropShadow() :default deg :dir direction :disabled display dpcm dpi dppx drop-shadow() Emboss() Engrave() element() ellipse() em :empty empty-cells :enabled ex Fade() FlipH() FlipV() fallback (@counter-style) filter <filter-function> :first :first-child '::first-letter (:first- letter) '::first-line (:first-line) :first-of-type fit-content() <flex> flex flex-basis flex-direction flex-flow flex-grow flex-shrink flex-wrap float :focus font @font-face font-family font-family (@font-face) font-feature-settings font-feature-settings (@font-face) @font-feature-values font-kerning font- language-override font-size font-size-adjust font-stretch font-stretch (@font-face) font-style font-style (@font-face) font-synthesis font-variant font- variant (@font-face) font-variant-alternates font-variant-caps font-variant-east-asian font-variant-ligatures font-variant-numeric font-variant-position font-variation-settings (@font-face) font-weight font-weight (@font-face) format() format() (@font-face) fr frames() <frequency> :fullscreen Glow() Gradient() GradientWipe() Gray() grad <gradient> grayscale() grid grid-area grid-auto-columns grid-auto-flow grid-auto-rows grid-column grid-column-end grid-column-gap grid-column-start grid-gap grid-row grid-row-end grid-row-gap grid-row-start grid-template grid-template-areas grid-template-columns grid- template-rows Hz hanging-punctuation height height (@viewport) @historical-forms :hover hsl() hsla() hue-rotate() hyphens ICMFilter() Inset() Invert() Iris() <ident> <image> image() image-orientation image-rendering image-resolution image-set() @import in :in-range :indeterminate inherit initial inline- size inset() <integer> :invalid invert() isolation justify-content kHz @keyframes Light() :lang :last-child :last-of-type leader() :left left @left-bottom <length> letter-spacing line-break line-height linear-gradient() :link list-style list-style-image list-style-position list-style-type local() MaskFilter() Matrix() MotionBlur() margin margin-block-end margin-block-start margin-bottom margin-inline-end margin-inline-start margin-left margin-right margin-top mask mask-clip mask-composite mask-image mask-mode mask-origin mask-position mask-repeat mask-size mask-type matrix() matrix3d() max-height max-height (@viewport) max-width max-width (@viewport) max-zoom (@viewport) @media min-block-size min-height min-height (@viewport) min-inline-size min-width min-width (@viewport) min-zoom (@viewport) minmax() mix-blend-mode mm ms ms-filter-alpha() ms-filter-basicimage() ms-filter-blendtrans() ms-filter-blur() ms-filter- chroma() ms-filter-compositor() ms-filter-dropshadow() ms-filter-emboss() ms-filter-engrave() ms-filter-fliph() ms-filter-flipv() ms-filter-glow() ms- filter-gray() ms-filter-icmfilter() ms-filter-invert() ms-filter-light() ms-filter-maskfilter() ms-filter-matrix() ms-filter-motionblur() ms-filter- redirect() ms-filter-revealtrans() ms-filter-shadow() ms-filter-wave() ms-filter-xray() ms-proceduralsurface-alphaimageloader() ms-proceduralsurface- gradient() ms-transition-barn() ms-transition-blinds() ms-transition-checkerboard() ms-transition-fade() ms-transition-gradientwipe() ms-transition-inset() ms-transition-iris() ms-transition-pixelate() ms-transition-radialwipe() ms-transition-randombars() ms-transition-randomdissolve() ms-transition-slide() ms- transition-spiral() ms-transition-stretch() ms-transition-strips() ms-transition-wheel() ms-transition-zigzag() @namespace negative (@counter- style) :not :nth-child :nth-last-child :nth-last-of-type :nth-of-type <number> object-fit object-position offset-block-end offset-block-start offset-inline- end offset-inline-start :only-child :only-of-type opacity opacity() :optional order orientation (@viewport) @ornaments ornaments() orphans :out-of-range outline outline-color outline-offset outline-style outline-width overflow overflow-wrap overflow-x overflow-y Pixelate() pad (@counter-style) padding padding-block-end padding-block-start padding-bottom padding-inline-end padding-inline-start padding-left padding-right padding-top @page page-break-after page-break-before page-break-inside pc <percentage> perspective perspective() perspective-origin place-content '::placeholder pointer-events polygon() <position> position prefix (@counter-style) pt px Q quotes RadialWipe() RandomBars() RandomDissolve() Redirect() RevealTrans() rad radial-gradient() range (@counter-style) <ratio> :read-only :read-write rect() rem repeat() repeating-linear-gradient() repeating-radial-gradient() :required resize <resolution> revert rgb() rgba() :right right @right-bottom :root rotate() rotate3d() rotateX() rotateY() rotateZ() ruby-align ruby-merge ruby-position Shadow() Slide() Spiral() Stretch() Strips() s saturate() scale() scale3d() scaleX() scaleY() scaleZ() :scope scroll-behavior scroll-snap-coordinate scroll-snap-destination scroll-snap-type '::selection sepia() <shape> shape-image-threshold shape-margin shape-outside skew() skewX() skewY() speak-as (@counter-style) src (@font- face) steps() <string> @styleset styleset() @stylistic stylistic() suffix (@counter-style) @supports @swash swash() symbols (@counter-style) symbols() system (@counter-style) tab-size table-layout :target target-counter() target-counters() target-text() text-align text-align-last text-combine-upright text- decoration text-decoration-color text-decoration-line text-decoration-style text-emphasis text-emphasis-color text-emphasis-position text-emphasis-style text-indent text-justify text-orientation text-overflow text-rendering text-shadow text-transform text-underline-position <time> <timing-function> top @top- center touch-action transform transform-box <transform-function> transform-origin transform-style transition transition-delay transition-duration transition-property transition-timing-function translate() translate3d() translateX() translateY() translateZ() turn unicode-bidi unicode-range (@font-face) unset <url> url() user-zoom (@viewport) :valid var() vertical-align vh @viewport visibility :visited vmax vmin vw Wave() Wheel() white-space widows width width (@viewport) will-change word-break word-spacing word-wrap writing-mode Xray() Zigzag() z-index zoom (@viewport) )--* approach #1 NOPE
23. approach #1 we need isolation
24. approach #1 inject DOM elements directly in the first party page
25. approach #1 inject DOM elements directly in the first party page
26. approach #2 web components
27. approach #2 scoped styles!
28. approach #2 • Not enough browser support • Polyfills are sloooooow* *ever tried YouTube on a non-chrome browser?
29. approach #2
30. approach #2 web components
31. approach #2 web components *for now *
32. approach #3 iframes
33. approach #3 iframes add one or two requests (HTML + JS)
34. approach #3 limited for communication
35. approach #3 iframes
36. approach #3 iframes
37. approach #4 ✨ sourceless ✨ iframes
38. approach #4 just use the iframe as a rendering target
39. approach #4 let iframe = document.createElement("iframe"); iframe.src = "about:blank"; console.log(iframe.contentWindow)
40. approach #4 browser issues!
41. browser issues! • IE can't access contentWindow without a domain • Firefox doesn't always fire a load event
42. approach #4 iframe.src = isIE ? "javascript:" + `'<script> window.onload = function() { document.domain = "first-party.domain" } !</script>'` : "about:blank";
43. approach #4 setTimeout( renderWithoutLoadEvent, ARBITRARY_TIMEOUT );
44. approach #4 design issues!
45. design issues! An iframe has a fixed height
46. set the iframe height dynamically from the first party page approach #4
47. watch the iframe's body height? approach #4
48. approach #4 My third-party elements iframe
49. approach #4 My third-party elements have grown iframe
50. approach #4 My third-party elements have grown iframe body grows
51. approach #4 My third-party shrank iframe but the body didn't shrink
52. watch the iframe's body height? approach #4
53. watch the iframe's body height? approach #4
54. watch a div container in the body approach #4
55. how do we watch? approach #4
56. IntersectionObserver? approach #4
57. approach #4
58. IntersectionObserver? approach #4
59. approach #4 IntersectionObserver?
60. approach #4 IntersectionObserver?
61. good old client rect! approach #4
62. approach #4 let lastHeight = 0; function tick() { let height = root.getBoundingClientRect().height; if(height ))!== lastHeight) { lastHeight = height; iframe.style.height = height + "px"; } requestAnimationFrame(tick); } requestAnimationFrame(tick);
63. only use window & document when you know what you're doing takeovers
64. use node.ownerDocument and document.defaultView takeovers
65. don't trust inheritance takeovers
66. don't trust inheritance arrayFromIframe instanceof Array #// false
67. don't trust inheritance Array.isArray(arrayFromIframe) #// true Object.prototype.toString .call(arrayFromIframe) ''=== "[object Array]" #// true
68. browsers! takeovers
69. 3rd party devs: hey, <animate /> doesn't work in sourceless iframes firefox: you want to use like ChromiumSVGs LOL wontfix takeovers
70. takeovers W3C their own APIs
71. 3rd party devs: hey, can we get a setting to let our logged customers say they want us to access their cookie so that we know if we need to show their admin interface? safari: no fuck off all third-party is trash takeovers
72. chrome: takeovers
73. how do we do layers/modals ? takeovers
74. let's build a dropdown Dropdown iframe Some first party page contents
75. approach #1: grow the iframe Dropdown iframe Some first party page contents Contents
76. approach #2: scrollviews Dropdown iframe Some first party page contents
77. Dropdown iframe Some first party page contents approach #3
78. Dropdown iframe Some first party page contents : more iframes™ Contents approach #3
79. React.createPortal is your friend takeovers
80. takeovers <iframe %/> Frame Loading
81. takeovers <iframe %/> Frame createPortal(el) Done
82. Environment.isThirdParty ? <Frame> child !</Frame> : child; takeovers
83. read-only storage no service workers takeovers
84. takeovers read-only storage no storage at all* ** no service workers *in safari and firefox **only fails after some time
85. your SDK needs to be small takeovers
86. no (or very few) polyfills takeovers
87. because MooTools or Prototype.js are still a thing takeovers
88. because MooTools or Prototype.js are still a thing takeovers
89. avoid bundler conflicts takeovers
90. avoid bundler conflicts { -/* ''... )*/ output: { -/* ''... )*/ jsonpFunction: "YOUR_OWN_NAMESPACE", } }
91. booting takeovers
92. domReady? onLoad? takeovers
93. async loop takeovers
94. async loop function checkSdk() { if(window.myBootingFunction) { window.myBootingFunction() } else { setTimeout(checkSdk, 40) } } checkSdk()
95. analytics? takeovers
96. analytics? • needs to load the actual script • needs to register events before the script is loaded
97. analytics? (function(_, b, e, o, p) { if (_.myTracker) { return; } _.myTracker = function myTracker() { myTracker.events.push([].slice.call(arguments)); }; myTracker.events = []; o = b.createElement(e); o.src = "https:#//example.com/path-to-real-script.js"; p = b.querySelector(e); p.parentNode.insertBefore(o, p); })(window, document, "script");
98. analytics? (function(_, b, e, o, p) { if (_.myTracker) { return; } _.myTracker = function myTracker() { myTracker.events.push([].slice.call(arguments)); }; myTracker.events = []; o = b.createElement(e); o.src = "https:#//example.com/path-to-real-script.js"; p = b.querySelector(e); p.parentNode.insertBefore(o, p); })(window, document, "script");
99. analytics? (function(_, b, e, o, p) { if (_.myTracker) { return; } _.myTracker = function myTracker() { myTracker.events.push([].slice.call(arguments)); }; myTracker.events = []; o = b.createElement(e); o.src = "https:#//example.com/path-to-real-script.js"; p = b.querySelector(e); p.parentNode.insertBefore(o, p); })(window, document, "script"); dedupe
100. analytics? (function(_, b, e, o, p) { if (_.myTracker) { return; } _.myTracker = function myTracker() { myTracker.events.push([].slice.call(arguments)); }; myTracker.events = []; o = b.createElement(e); o.src = "https:#//example.com/path-to-real-script.js"; p = b.querySelector(e); p.parentNode.insertBefore(o, p); })(window, document, "script"); dedupe register
101. analytics? (function(_, b, e, o, p) { if (_.myTracker) { return; } _.myTracker = function myTracker() { myTracker.events.push([].slice.call(arguments)); }; myTracker.events = []; o = b.createElement(e); o.src = "https:#//example.com/path-to-real-script.js"; p = b.querySelector(e); p.parentNode.insertBefore(o, p); })(window, document, "script"); dedupe register load
102. API takeovers
103. API • existing installations need to work forever • never introduce a breaking change
104. when making a third- party widget: we need to keep all that in mind, at every step takeovers
105. because reverting a design decision is hard takeovers
106. • not your page • not your domain • not a controlled env
107. tl;dr; takeovers • styles: f*cked, iframes • scripts: f*cked, limitations • API: f*cked, retrocompat • storage: f*cked, do without
108. thank you!
109. thank you! Matthias Le Brun @bloodyowl questions?