<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>14318</bug_id>
          
          <creation_ts>2011-09-27 22:11:54 +0000</creation_ts>
          <short_desc>Importance of the upgradeneeded event should be more explicit</short_desc>
          <delta_ts>2011-12-27 22:00:39 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebAppsWG</product>
          <component>Indexed Database API</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P1</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Kyle Huey">me</reporter>
          <assigned_to name="This bug has no owner yet - up for the taking">dave.null</assigned_to>
          <cc>eliotgra</cc>
    
    <cc>jonas</cc>
    
    <cc>mike</cc>
    
    <cc>public-webapps</cc>
          
          <qa_contact>public-webapps-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>57453</commentid>
    <comment_count>0</comment_count>
    <who name="Kyle Huey">me</who>
    <bug_when>2011-09-27 22:11:54 +0000</bug_when>
    <thetext>It is never explicitly stated that the upgradeneeded event is your one chance to modify the database schema.  This only becomes apparent after reading the VERSION_CHANGE transaction steps in detail.  It&apos;s easy to miss this subtle point (at least it was for me :-P).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>57458</commentid>
    <comment_count>1</comment_count>
    <who name="Jonas Sicking (Not reading bugmail)">jonas</who>
    <bug_when>2011-09-28 00:36:54 +0000</bug_when>
    <thetext>Did it seem like there was any other way to get a VERSION_CHANGE transaction? If so, where? There would likely be the place to indicate that it does not, in fact, produce a VERSION_CHANGE transaction.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>62066</commentid>
    <comment_count>2</comment_count>
    <who name="Eliot Graff">eliotgra</who>
    <bug_when>2011-12-27 22:00:39 +0000</bug_when>
    <thetext>Added the following note to the Editor&apos;s Draft of 12/27:

A VERSION_CHANGE transaction is automatically created when, during the open database API, a database version number is provided that is greater than the current database version.  This transaction will be active inside the onupgradeneeded event handler, allowing the creation of new object stores and indexes.

Thanks,

Eliot</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>